Skip to content

Add words to your dictionary

EkLine’s spell-check rule flags words it doesn’t recognize. That’s useful for catching typos, but it also flags product names, acronyms, and domain jargon that are spelled correctly for your team. Add those words to your dictionary once, and EkLine treats them as valid everywhere you review.

Your dictionary lives in your EkLine account, so it applies to every review surface connected to your token: the CLI, CI pipelines, the VS Code extension, and the PR bot.

You need:

  • An EkLine account with access to the EkLine Dashboard.
  • One review surface set up to test the result: the CLI, a CI integration, or the VS Code extension.
  • Reviews that use your organization’s own rules, not a built-in style guide. A built-in style guide (Google, Microsoft, or Marketing) uses EkLine’s shared rules, which don’t include your dictionary. In VS Code, set Style Guide to Custom. In the CLI and CI, leave styleGuide out of ekline.config.json and don’t pass --style-guide.

  1. Go to the EkLine Dashboard.

  2. Go to Settings > Organization > Dictionary, or open ekline.io/dictionary.

The dictionary shows your saved words, each with a Case-sensitive toggle, and an empty row ready for a new entry.

The EkLine dictionary page showing saved words, each with a case-sensitive toggle, an empty Word field, and the Add New Word and Update Dictionary buttons
  1. Enter a word in the Word field. You can add a multi-word term, such as a product name with spaces.

  2. Set the Case-sensitive toggle for that word (see Match exact capitalization).

  3. Click Add New Word and repeat for each term you want EkLine to accept.

  4. Click Update Dictionary to save your dictionary.

  5. Click Apply Configuration, then click Apply Configuration again to confirm.

Update Dictionary saves your words, and Apply Configuration sends them to your reviews. Changes take effect within 5 minutes.

The Case-sensitive toggle controls how EkLine matches a word:

ToggleBehaviorExample
Off (default)EkLine accepts the word in any capitalization.kubernetes, Kubernetes, and KUBERNETES all pass.
OnEkLine accepts only the exact spelling you enter. Other capitalizations are still checked.Adding EkLine accepts EkLine, but ekline is still reviewed.

Turn the toggle on when the correct form of a word depends on its capitalization, so EkLine keeps flagging the wrong casing.


Run a review against content that has one of the words you added, and confirm EkLine no longer flags it.

Terminal window
ekline-cli --ek-token YOUR_TOKEN --content-directory ./docs

The word no longer appears in the output with the rule ID EK00300.

If the word still gets flagged, see Troubleshooting.


  • Confirm you clicked Update Dictionary and then Apply Configuration. Reviews use your words only after you apply them, and changes take effect within 5 minutes.
  • Check which style guide the review uses. A built-in style guide (Google, Microsoft, or Marketing) doesn’t use your dictionary. In VS Code, set Style Guide to Custom. In the CLI and CI, remove styleGuide from ekline.config.json and don’t pass --style-guide.
  • Check the Case-sensitive toggle. If it’s on, EkLine accepts only the exact capitalization you entered. Turn it off to accept every capitalization.
  • Run the review again. EkLine applies dictionary changes on the next review, not to results from a review that already ran.

EkLine prevents duplicate entries. If you see a duplicate error, remove the extra row with the X button next to it, then save.

Enforce a preferred term instead of accepting a word

Section titled “Enforce a preferred term instead of accepting a word”

The dictionary accepts a word but doesn’t suggest a replacement. To steer writers from one term to another, for example from e-mail to email, add the pair under Settings > Organization > Terminology: the term to avoid and its alternative. Then select Apply Configuration; changes take effect within 5 minutes.


Built on Potluck Docs, our open source template.