Interface OverrideSettings

True to enable compound word checking. See Case Sensitivity for more details.

Default

false
Copy

Determines if words must match case and accent rules.

• false - Case is ignored and accents can be missing on the entire word. Incorrect accents or partially missing accents will be marked as incorrect.
• true - Case and accents are enforced.

Default

false
Copy

Optional description of configuration.

Optional list of dictionaries to use. Each entry should match the name of the dictionary.

To remove a dictionary from the list, add ! before the name.

For example, !typescript will turn off the dictionary with the name typescript.

See the Dictionaries and Custom Dictionaries for more details.

Define additional available dictionaries.

For example, you can use the following to add a custom dictionary:

"dictionaryDefinitions": [
  { "name": "custom-words", "path": "./custom-words.txt"}
],
"dictionaries": ["custom-words"]
Copy

Enable / Disable checking file types (languageIds).

These are in additional to the file types specified by cSpell.enabledLanguageIds.

To disable a language, prefix with ! as in !json,

Example:

jsonc       // enable checking for jsonc
!json       // disable checking for json
kotlin      // enable checking for kotlin
Copy

Title

File Types to Check

Scope

resource

Unique Items

true

Is the spell checker enabled.

Default

true
Copy

languageIds for the files to spell check.

Glob pattern or patterns to match against.

List of words to always be considered incorrect. Words found in flagWords override words.

Format of flagWords

• single word entry - word
• with suggestions - word:suggestion or word->suggestion, suggestions

Example:

"flagWords": [
  "color: colour",
  "incase: in case, encase",
  "canot->cannot",
  "cancelled->canceled"
]
Copy

Optional identifier.

List of regular expression patterns or pattern names to exclude from spell checking.

Example: ["href"] - to exclude html href pattern.

Regular expressions use JavaScript regular expression syntax.

Example: to ignore ALL-CAPS words

JSON

"ignoreRegExpList": ["/\\b[A-Z]+\\b/g"]
Copy

YAML

ignoreRegExpList:
  - >-
   /\b[A-Z]+\b/g
Copy

By default, several patterns are excluded. See Configuration for more details.

While you can create your own patterns, you can also leverage several patterns that are built-in to CSpell.

List of words to be ignored. An ignored word will not show up as an error, even if it is also in the flagWords.

List of regular expression patterns or defined pattern names to match for spell checking.

If this property is defined, only text matching the included patterns will be checked.

While you can create your own patterns, you can also leverage several patterns that are built-in to CSpell.

Additional settings for individual languages.

See Language Settings for more details.

By default, the bundled dictionary configurations are loaded. Explicitly setting this to false will prevent ALL default configuration from being loaded.

Default

true
Copy

The maximum number of times the same word can be flagged as an error in a file.

Default

5
Copy

The maximum number of problems to report in a file.

Default

10000
Copy

The minimum length of a word before checking it against a dictionary.

Default

4
Copy

Optional name of configuration.

Optional list of dictionaries that will not be used for suggestions. Words in these dictionaries are considered correct, but will not be used when making spell correction suggestions.

Note: if a word is suggested by another dictionary, but found in one of these dictionaries, it will be removed from the set of possible suggestions.

Number of suggestions to make.

Default

10
Copy

Parser to use for the file content

Version

6.2.0

Defines a list of patterns that can be used with the ignoreRegExpList and includeRegExpList options.

For example:

"ignoreRegExpList": ["comments"],
"patterns": [
  {
    "name": "comment-single-line",
    "pattern": "/#.*​/g"
  },
  {
    "name": "comment-multi-line",
    "pattern": "/(?:\\/\\*[\\s\\S]*?\\*\\/)/g"
  },
  // You can also combine multiple named patterns into one single named pattern
  {
    "name": "comments",
    "pattern": ["comment-single-line", "comment-multi-line"]
  }
]
Copy

Defines a list of patterns that can be used with the ignoreRegExpList and includeRegExpList options.

The PnP files to search for. Note: .mjs files are not currently supported.

Default

[".pnp.js", ".pnp.cjs"]
Copy

A list of suggested replacements for words. Suggested words provide a way to make preferred suggestions on word replacements. To hint at a preferred change, but not to require it.

Format of suggestWords

• Single suggestion (possible auto fix)
  • word: suggestion
  • word->suggestion
• Multiple suggestions (not auto fixable)
  • word: first, second, third
  • word->first, second, third

The maximum number of changes allowed on a word to be considered a suggestions.

For example, appending an s onto example -> examples is considered 1 change.

Range: between 1 and 5.

Default

3
Copy

The maximum amount of time in milliseconds to generate suggestions for a word.

Default

500
Copy

Packages managers like Yarn 2 use a .pnp.cjs file to assist in loading packages stored in the repository.

When true, the spell checker will search up the directory structure for the existence of a PnP file and load it.

Default

false
Copy

List of words to be considered correct.