How Do I Bulk Import Dictionary Items and Snippets?

Last updated: April 22, 2026

Available on: Mac, Windows

Need to add hundreds of dictionary words or snippets without typing them one by one? Upload a CSV or JSON file to import up to 1,000 items in seconds.

Important: Bulk import requires a paid subscription, active trial, or enterprise/team membership. Users on a free plan without an active trial or team membership will not see the Experimental settings page.

How to enable bulk import

  1. Open the Flow app.

  2. Go to Settings → Experimental.

  3. Toggle on Bulk import.

  4. Exit Settings and open the Dictionary or Snippets tab.

An Import button now appears in the top-right corner.

How to import dictionary items

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

  2. Click Import.

  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. Bulk-imported items display an upload badge icon so you can identify where each word came from.

Tip: The import target (personal or team) defaults to match the tab you were viewing when you clicked Import. You can change it using the Share with team toggle on the upload screen.

Note: Bulk-imported items are not starred by default. To prioritize specific words, star them and use the Starred first sort option in the Sort by menu.

Dictionary file format

Dictionary imports use CSV format 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

Dictionary words or phrases (the first column) can be up to 60 characters long. Correction/replacement text (the second column) can be up to 4,000 characters long. Rows exceeding either limit are skipped.

Fields containing commas should be wrapped in double quotes (e.g., "hello, world",greeting). The parser follows standard CSV (RFC 4180) quoting rules.

Manvi Constanza Q3 Roadmap Wispr Flow Figma Jam "Monvi", "Manvi" "Whisper Flow", "Wispr Flow" "by the way", "btw"

How to import snippets

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

  2. Click Import.

  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.

Snippets file format

Snippets must be formatted as a JSON array with objects containing "name" and "text" fields.

Snippet trigger names can be up to 60 characters, and expansion text can be up to 4,000 characters. Entries exceeding these limits are skipped.

Both name and text must be strings. Entries with non-string values (numbers, booleans) are skipped. Whitespace-only values are treated as empty and skipped. Extra fields beyond name and text are ignored.

[ { "name": "linkedin", "text": "https://www.linkedin.com/in/john-doe-9b0139134/" }, { "name": "intro email", "text": "Hey, would love to find some time to chat later..." }, { "name": "my calendly link", "text": "calendly.com/you/invite-name" } ]

FAQs

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.

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.

Some items were skipped

Items can be skipped for several reasons:

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

  • In-file duplicates: Only the first occurrence of each 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.

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 you select from the Sort by menu. Options include Starred first, Newest first, Oldest first, and Alphabetical (A-Z). To keep important words at the top, star them and use the Starred first sort.

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

Yes. If the bulk-imported word already has a correction (from your CSV), click the word in your Vocabulary list to edit it. To add a new correction to a word that was imported without one, click Add new, enable Correct a misspelling, and enter the same word — Flow will upgrade the existing entry with your correction. You can also include corrections directly in your CSV file at import time 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 bulk import on mobile?

No. Bulk import is only available on Mac and Windows. Items you import on desktop sync automatically to your mobile devices. On iOS, you can view, add, edit, delete, and copy synced dictionary words and snippets. On Android, you can view, search, add, edit, and delete both dictionary words and snippets.

Limitations and notes

  • Bulk import is available on Mac and Windows only.

  • Each import is limited to 1,000 items and 3 MB file size.

  • Dictionary items use CSV format; Snippets use JSON format.

  • Imported items sync across all your devices. Each device syncs with the cloud independently, so there may be a brief delay before new imports appear on other devices.

  • Bulk-imported words appear with an upload badge icon to indicate their source.

  • On iOS, synced dictionary words and snippets can be viewed, added individually, edited, deleted, and copied — but bulk import and search are only available on desktop. On Android, dictionary words and snippets can be viewed, searched, added individually, edited, and deleted — but bulk import is only available on desktop.

  • Duplicate checking applies across both dictionary words and snippets — if a snippet trigger matches an existing dictionary word (or vice versa), it is treated as a duplicate.

  • When importing to a team library, duplicates are checked only against existing team entries. A word in your personal dictionary will not prevent the same word from being imported to the team library.

Still need help?

Reach out to our support team if:

  • Your file meets the required format but still won't import

  • Imported items are missing or incorrect after a successful import

Include your platform (Mac or Windows), the file you tried to import, and a description of what happened.