1. Help Center
  2. Supported formats

React-Intl Nested JSON

Learn what a React-Intl Nested JSON file is and how Phrase processes it

File Extensions .json
API Extension react_nested_json
Import Yes
Export Yes
Pluralization supported? Yes
Descriptions supported? No

As discussed in React-Intl Simple JSON, React Intl uses .js files to save localized data. Using Phrase, all you need to do is to put the strings into a JSON file and reference it in your source code. Depending on your app configurations, your JSON file might take a rather complex structure with multiple JSON objects nested together. The way Phrase processes your nested JSON files is by separating key levels with a dot. During export, all keys will be split again and rendered as a nested JSON structure.

Code Sample

  "boolean_key": "--- true\n",
  "empty_string_translation": "",
  "key_with_description": "Check it! This key has a description! (At least in some formats it does)",
  "key_with_line-break": "This translations contains\na line-break.",
  "nested": {
    "deeply": {
      "key": "Hey, 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": "A simple key with a simple message.",
  "unverified_key": "Translation is not yet verified and waits for it. (In some formats we also export this status)"