1. Help Center
  2. Supported formats

Nested JSON

Learn how to manage JSON format with possible nested keys in Phrase.

JSON format with possible nested keys. Keys will be stored by separating levels with a dot '.' . During export, all keys will be split again and rendered as nested JSON structure.

File Extensions .json
API Extension nested_json
Import Yes
Export Yes
Pluralization supported? Yes
Descriptions supported? No
Format Options enable_pluralization

Code Sample

  "boolean_key": "--- true\n",
  "empty_string_translation": "",
  "key_with_description": "Check it out! This key has a description! (At least in some formats)",
  "key_with_line-break": "This translations contains\na line-break.",
  "nested": {
    "deeply": {
      "key": "Wow, this key is nested even deeper."
    "key": "This key is nested inside a namespace."
  "null_translation": null,
  "pluralized_key": {
    "one": "Only one pluralization found.",
    "other": "Wow, you have %s pluralizations!",
    "zero": "You have no pluralization."
  "sample_collection": [
    "first item",
    "second item",
    "third item"
  "simple_key": "Just a simple key with a simple message.",
  "unverified_key": "This translation is not yet verified and waits for it. (In some formats we also export this status)"

Format Options

Identifier enable_pluralization
Type boolean
Upload Yes
Download No
Default true
Description Enables detection of pluralized keys. All matching keys will be persisted as pluralized keys.



This format uses named categories to identify the different pluralizations of a key. The following categories are reserved for pluralization:

.zero | .one | .two | .few | .many | .other

Example key names:

This way pluralized keys can be identified, persisted and marked accordingly.
Learn more about pluralization?