> For the complete documentation index, see [llms.txt](https://help.dictanote.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dictanote.co/help/general/make-your-web-app-voice-in-compatible.md).

# Make your web app Voice In compatible

*This is a technical guide for developers.*

Voice In inserts dictated text into text input fields, `<textarea>` elements, and editable elements such as `<div contenteditable="true">`. Standard editable fields should work by default, but custom event handling can affect insertion.

## Check page access

Voice In works on ordinary web pages. Browser-internal pages, extension pages, and extension stores restrict access. Local `file://` pages require the user to [allow access to file URLs](https://help.dictanote.co/help/features/how-to-enable-dictation-on-local-file-urls.md).

If your editor is in an iframe, check access to the frame's URL as well as the top-level page. Voice In includes content scripts for frames; a different origin alone does not establish that the editor is unsupported. Test the same editable field outside the iframe to isolate frame-specific problems.

## Check input and paste handling

If your JavaScript modifies or replaces inserted text, test whether that logic removes Voice In's changes. Consider handling text changes through appropriate input or change events rather than relying only on keyboard events. The right event depends on your editor; do not remove keyboard handling that other features need.

Advanced Mode can use paste-based insertion. An editor that only updates its state in a particular keyboard or paste handler may miss changes made by another insertion method. Test that dictated text appears, remains in the field after a render, and is included when the form is submitted.

## Test compatibility

1. Focus the field and dictate a short sentence.
2. Dictate another phrase and check the space between the two phrases.
3. Submit or save the form, and confirm that the application received the text.
4. If insertion fails, try [Advanced Mode](https://help.dictanote.co/help/features/how-to-enable-or-disable-advanced-mode.md) and compare the result.

For help with a specific editor, [contact support](https://help.dictanote.co/help/contact-us.md) with a test page or a minimal example and the steps that fail.
