> 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/plus/ai-transforms.md).

# AI Transforms

AI Transforms let you rewrite text with AI using a keyboard shortcut. Select the text in a field and press the shortcut. Voice In replaces the selection with the rewritten text. Use them to clean up a rough draft without leaving the page. They work in supported text fields, but not in editors such as Google Docs where Voice In cannot read the selection.

AI Transforms is a **Voice In Plus** feature and is currently in **beta**.

## Set up AI Transforms

1. Open the [Voice In Options page](https://dictanote.co/voicein/options/) and scroll to the **AI Transforms** section. Each Transform appears as a card with its keyboard shortcut.
2. Check the shortcut shown on each card. Polish has a default shortcut: **Alt+1** on Windows, **Option+1** on Mac, or **Alt+Shift+1** on other platforms. Existing assignments or conflicts can change what is available.
3. To change shortcuts, click **Change Keyboard Shortcuts**, or open `chrome://extensions/shortcuts` (Edge: `edge://extensions/shortcuts`). Under **Voice In**, assign shortcuts to **AI Transform 1: Polish** and **AI Transform 2: Custom style**. The second Transform has no default shortcut.
4. On the Options page, click **Try it out** to practice on a sample passage. The sample text is already selected, so press the Polish shortcut.

For more about keyboard shortcuts in Voice In, read the [Keyboard Shortcuts](https://help.dictanote.co/help/features/keyboard-shortcuts.md) article.

## How it works

1. Dictate or type your text as usual.
2. Select the text that you want to rewrite. To select all the text in a field, press **Ctrl+A** (Windows) or **⌘A** (Mac) in the field.
3. Press the shortcut for the Transform that you want. A progress notice, such as "Polishing…", appears at the top of the page while the rewrite runs.
4. The rewritten text replaces your selection. To restore the original text, press **Ctrl+Z** / **⌘Z**.

When you run a Transform, Voice In sends the selected text and transformation instructions to its server for AI processing, then returns the rewritten text to the page. Ordinary dictation does not automatically submit text to AI Transforms.

## Available Transforms

| Transform         | What it does                                                                                                                                                                                                 |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| **Polish**        | Fixes speech-recognition errors, grammar, punctuation, and capitalization, and makes the text clearer and more concise. Keeps your meaning, voice, and paragraph breaks, and adds nothing new.               |
| **Custom Polish** | Polish with your own rules added. By default, it keeps words that you wrote in ALL CAPS and keeps your own wording instead of shortening it. Click **Edit** on its card to change the rules or replace them. |

For example, dictate *"the moon is the only natural satellite of earth it orbits around earth at an average distance of 384399 km"* and run **Polish**. The result is *"The Moon is the only natural satellite of Earth. It orbits Earth at an average distance of 384,399 km."*

Use **Custom Polish** when you like Polish but want it to behave a little differently. For example, take the text *"You should be putting that information on the Trello card then copying it and pasting it into WhatsApp NOT the OTHER WAY AROUND"*. **Polish** lowercases the capitalized words and rewords the sentence. **Custom Polish** adds the punctuation and keeps everything else: *"You should be putting that information on the Trello card, then copying it and pasting it into WhatsApp, NOT the OTHER WAY AROUND."*

## Customize Custom Polish

1. On the Options page, click **Edit** on the **Custom Polish** card. On a card that you haven't changed yet, you can also click **Add your own rules →**.
2. The **Instructions** box starts with the Polish instructions, followed by a list of rules. Add your own rules to the end of the list, one per line, each starting with "- ". These rules take priority over the Polish instructions. For example:
   * `- Write spoken abbreviations in capital letters with no spaces, for example "b i d" becomes "BID".`
   * `- Spell out numbers from one to ten as words.`
3. To start from a different template, click one of the options next to **Start from**: **Medical dictation**, **Punctuation only**, **Professional email**, **Meeting notes**, or **Prompt Engineer**. You can also replace all the instructions with your own, for a different style or format.
4. Optionally, change the **Style name**. The name appears on the card and in the progress notice.
5. Click **Save**. To go back to the original instructions, click **Reset to Custom Polish**.

## Good to know

* **Select text first.** If no text is selected when you press the shortcut, Voice In shows "Couldn't detect any text. Select the text, then run Polish again." Select the text and try again.
* **Sites.** Dictation support does not always mean AI Transforms support. In editors such as Google Docs, the extension cannot read the selected text to rewrite it.
* **Limits.** One Transform accepts up to 20,000 characters. Each account also has a generous daily limit, which keeps the service fast for everyone.
* **Only the second Transform is editable.** Polish always uses the built-in instructions. On the browser's keyboard shortcuts page, the second Transform is listed as **AI Transform 2: Custom style**.
* **Prompt Engineer.** Earlier versions used Prompt Engineer as the second Transform. If you never changed it, it is now Custom Polish. If you changed it, your version is kept. To use Prompt Engineer again, click **Edit**, then select **Prompt Engineer** next to **Start from**.

## Troubleshooting

* **"AI Transforms need Voice In Plus"**: This feature needs an active Voice In Plus subscription. See [Upgrade To Plus](https://help.dictanote.co/plus/upgrade-to-plus.md) and [Activate Plus](https://help.dictanote.co/plus/activate-plus.md).
* **Nothing happens when I press the shortcut**: Make sure that a shortcut is assigned on `chrome://extensions/shortcuts`, the cursor is in a text field on the page, and text is selected. If you updated Voice In recently, reload the page and try again.
* **"Please sign in to Voice In again"**: Your Voice In Plus session has expired. Open the Options page and sign in again.

If you have any other problem, email us at <support@dictanote.co>.
