.JSON - Nested (Strings)

Content is machine translated from English by Phrase Language AI.

File Extensions	.json
API Extension	nested_json
Import	Yes
Export	Yes
Plural forms support	Yes
Description support	No
Format options These options that can be specified when a file is uploaded and/or downloaded. Depending on the upload/download method (API, CLI, Repo sync etc.), they can be specified in query parameters `Upload`, `Download` or in the `phrase.yml` configuration file.	enable_pluralization

Nested JSON is a .JSON file with a large portion of values being other .JSON objects. Compared with Simple JSON, Nested JSON provides higher clarity by decoupling objects into different layers, making it easier to maintain. Keys are stored by separating levels with a dot .. During export, all keys are again split and rendered in the original nested .JSON structure.

AI chatbots can be very effective at generating a list of keys from a .JSON file.

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.

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)"
}

Plural forms

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

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

Example names for correctly identified, persisted and marked pluralized keys:

inbox.messages.notification.one
inbox.messages.notification.other

Plurals for JSON files

The most common format of plural key messages on various libraries:

"messages": {
    "one": "One message received.",
    "other": "%s messages received.",
    "zero": "No messages received."
}