How Do I Bulk Import Dictionary Items and Snippets?

Dictionary items (CSV)

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. For a team library, enable the Share with team toggle before selecting the file.

4. Review the preview screen, which shows duplicates as a skipped count.

5. Click Import [N] items. Your new items appear in the Dictionary list with an upload badge icon marking their source.

File format: CSV with one or two columns:

• Vocabulary items: one column — words Flow should recognize.

• Misspellings: two columns — maps an incorrect phrase to the correct one. Dictionary words and corrections are limited to 60 characters each; longer words or rows are skipped.

Wrap fields containing commas in double quotes (for example, "hello, world",greeting); standard CSV quoting rules apply. Both Unix and Windows line endings are supported, and whitespace around each field is trimmed.

Snippets (JSON)

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. For a team library, enable the Share with team toggle before selecting the file.

4. Review the preview screen to confirm how many items will import 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, plain text only.

• Type: both fields must be strings. Entries with non-string, whitespace-only, or over-limit values are skipped; fields other than name and text are ignored.

I don't see the Import option

Confirm your subscription qualifies (see the Important callout at the top of this article), then enable bulk import under Settings → Experimental.

My file won't upload

Use CSV for Dictionary items and JSON for Snippets, under 3 MB and no more than 1,000 items. Error messages:

• Incorrect file type. Please upload a .csv file — wrong file extension.

• File is too large (max 3MB) — over the size limit.

• Cannot import more than 1,000 entries. Please try again. — more than 1,000 items.

• Incorrect file format — the CSV or JSON is malformed.

• Failed to parse file or Failed to read file — the file could not be parsed or read.

• Failed to import — the import stopped partway through (for example, a network error); the modal returns to the Upload screen so you can retry.

An empty file produces its own distinct error message.

Why were some of my items skipped?

• Duplicates in your library: existing items are filtered out, matched case-insensitively — "Flow" and "flow" are the same word. Team imports are checked against the team dictionary.

• Duplicates within your file: when the same phrase appears more than once (regardless of case), only the first occurrence is kept.

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

• Dictionary/snippet conflicts: a word cannot exist as both a dictionary entry and a snippet trigger.

• Seeded default entries: new accounts ship with defaults ('btw' → 'by the way', 'Wispr Flow', your first name, and snippets such as 'my email address', 'my Flow referral', 'organize thoughts prompt'), which may be skipped as duplicates on your first import.

If every item already exists, the preview says all items are duplicates and offers only a Done button.

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

List order follows the Sort by menu. Dictionary offers Starred first, Newest first, Oldest first, and Alphabetical (A–Z); Snippets offers only Newest first, Oldest first, and Alphabetical.

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. For a word imported without one, click Add new, enable Correct a misspelling, and enter the same word — Flow upgrades the existing entry. You can also include corrections in your CSV using the two-column format.

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

Both entries can exist and both are used during dictation — duplicates are checked within each library, not across them.

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). iOS Dictionary is a single flat list; the All / Personal / Shared with team tabs are desktop-only.

• Android: Dictionary and Snippets are not yet available.