Key Ignoring

Ignored keys are excluded from translation processing entirely. They do not appear in target files - the CLI skips them during content discovery and never sends them to the translation backend.

Configuration#

Add ignoredKeys to a bucket in i18n.json:

{
  "buckets": {
    "json": {
      "include": ["locales/[locale].json"],
      "ignoredKeys": ["internal/debug", "dev/testData"]
    }
  }
}

How it works#

Given this source file:

{
  "welcome": "Welcome to our platform",
  "internal": {
    "debug": "Debug mode enabled",
    "testData": "Sample test content"
  }
}

With "ignoredKeys": ["internal/debug", "internal/testData"], the Spanish target file becomes:

{
  "welcome": "Bienvenido a nuestra plataforma"
}

The entire internal section is absent from the target file.

Key path notation#

Use forward slash (/) for nested keys and asterisk (*) for wildcards:

{ "ignoredKeys": ["internal/*", "dev/settings"] }

Keys containing dots work naturally - dev/api.mock targets "api.mock" inside "dev".

Key Ignoring vs. Key Locking#

Next Steps#