How Do I Bulk Import Dictionary Items and Snippets?

Last updated: April 30, 2026

Available on: Mac, Windows. iOS and Android can view and edit synced items, but cannot bulk import.

Add hundreds of dictionary words or snippets in seconds by uploading a CSV or JSON file — up to 1,000 items per import, no manual entry required.

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. 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 with an upload badge icon so you can identify their source.

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

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.

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.

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

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.

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.

  • 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.

[
  {
    "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"
  }
]

Common issues

Editing a snippet or dictionary word created a duplicate entry

This was caused by a bug where editing an existing snippet or dictionary word left the original entry behind, resulting in two copies. Fixed in version 1.8.5. Update Wispr Flow to the latest version to resolve this.

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.

  • 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. 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.

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. A word can only be used in one place. If you try to add a word that exists in the other list, Flow shows an error message. During bulk import, conflicting items are skipped.

Can I bulk import on mobile?

No. Bulk import is desktop-only. Items you import on Mac or Windows sync automatically to your mobile devices, where you can view and edit them individually.

Limitations and notes

  • Bulk import is available on Mac and Windows only. On iOS and Android, you can view and edit synced items individually but cannot bulk import.

  • Each import is limited to 1,000 items and a 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 elsewhere.

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

  • 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. Most import issues are resolved in one reply.