How Do I Bulk Import Dictionary Items and Snippets?

Dictionary items (CSV)

Follow these steps to import dictionary items:

1. Open the Flow app and go to the Dictionary page.

2. Click Import in the top-right corner.

3. Click the upload zone or drag and drop your CSV file. To import to a team library, enable the Share with team toggle before selecting your file.

4. Review the preview screen. Duplicates are shown as a skipped count.

5. Click Import [N] items to finalize. Your new items appear in the Dictionary list with an upload badge icon so you can identify their source.

File format: CSV with one or two columns:

• Vocabulary items: Single entries (one column) — words Flow should recognize.

• Misspellings: Two columns — maps an incorrect phrase to the correct one.

The first column (word or phrase) can be up to 60 characters. The second column (correction) can be up to 4,000 characters. Rows exceeding either limit are skipped.

Wrap fields containing commas in double quotes (for example, "hello, world",greeting). The parser follows standard CSV (RFC 4180) quoting rules.

Snippets (JSON)

Follow these steps to import snippets:

1. Open the Flow app and go to the Snippets page.

2. Click Import in the top-right corner.

3. Click the upload zone or drag and drop your JSON file. To import to a team library, enable the Share with team toggle before selecting your file.

4. Review the preview screen to confirm how many items will be imported and how many duplicates were skipped.

5. Click Import to finish.

File format: JSON array of objects with name and text fields.

• Trigger name: Up to 60 characters.

• Expansion text: Up to 4,000 characters.

• Type: Both fields must be strings. Entries with non-string values, whitespace-only values, or values exceeding the limits are skipped. Extra fields beyond name and text are ignored.

Editing a snippet or dictionary word created a duplicate entry on Android

This was caused by a sync bug on older Android versions, which has since been fixed. If you're on an older Android version:

1. Update Wispr Flow on Android to the latest version.

2. Restart the app after updating.

I don't see the Import option

Make sure you have an active paid subscription or trial, then enable bulk import under Settings → Experimental. The Experimental page is only available to paying subscribers and users on an active trial — expired trials do not count.

My file won't upload

Check that you're using a CSV file for Dictionary items or a JSON file for Snippets. Files must be under 3 MB and contain no more than 1,000 items.

Why were some of my items skipped?

Items can be skipped for several reasons:

• Duplicates in your library: Items that already exist are filtered out. Matching is case-insensitive — "Flow" and "flow" are treated as the same word.

• Duplicates within your file: Only the first occurrence of each repeated phrase is kept.

• Malformed rows: CSV rows with more than two columns or unterminated quotes are skipped.

• Team imports: Duplicates are checked against the team dictionary when importing to a team library.

• Dictionary/snippet conflicts: A word cannot exist as both a dictionary entry and a snippet trigger. Conflicting items are skipped.

All items show as duplicates

If every item in your file already exists in your library, the preview shows a message stating all items are duplicates, with only a Done button.

My imported words aren't appearing at the top of the list

Your Dictionary list order depends on the sort mode in the Sort by menu. Dictionary options include Starred first, Newest first, Oldest first, and Alphabetical (A–Z). To keep important words at the top, star them and use Starred first.

The Snippets page has only three sort options (Newest first, Oldest first, and Alphabetical) and does not support starring.

Can I add a correction to a bulk-imported word?

Yes. If the word already has a correction from your CSV, click it in your Vocabulary list to edit it. To add a correction to a word imported without one, click Add new, enable Correct a misspelling, and enter the same word — Flow will upgrade the existing entry. You can also include corrections directly in your CSV using the two-column format.

What happens if the same word is in my personal and team dictionary?

Your personal dictionary entry takes priority during dictation.

Can I use the same word as both a dictionary entry and a snippet trigger?

No. The dictionary and snippets are cross-checked — adding a word (manually or via bulk import) that already exists as a snippet trigger, or vice versa, is silently skipped and the entry will not be added.

Can I bulk import on mobile?

No, bulk import is desktop-only. Items sync to mobile where you can manage them individually:

• iOS: view, add, edit, delete, and copy items. Team and enterprise users can also use Move to team dictionary (available when not viewing the Team tab).

• Android: view, search, filter (All / Personal / Shared with Team), add, edit, and delete items. Copy and move-to-team are not supported on Android.