Supported File Types (Strings)

.JSON - Simple (Strings)

File Extensions

.json

API Extension

simple_json

Import

Yes

Export

Yes

Plural forms support

Yes

Description support

No

Format options

enable_pluralization

.JSON (JavaScript Object Notation) was originally designed only for JavaScript, but became a standard exchange file format in parallel with ,XML, ,YAML, ,Properties, etc. .JSON consists of key-value pairs wrapped in curly brackets. A value can either be a string, a number, or an object (one or more key-value pairs wrapped in curly brackets). Simple JSON is a .JSON file with most values being plain strings excepting for plural forms purposes. In this case, strings placed as values will be translated.

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.",
  "nested.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."
}
Was this article helpful?

Sorry about that! In what way was it not helpful?

The article didn’t address my problem.
I couldn’t understand the article.
The feature doesn’t do what I need.
Other reason.

Note that feedback is provided anonymously so we aren't able to reply to questions.
If you'd like to ask a question, submit a request to our Support team.
Thank you for your feedback.