Skip to main content

Keys

Concepts of Keys​

When working with translation keys, it’s important to understand several key concepts that help organize and improve translation quality:

  • Code
    The unique identifier for each translation key, used to reference the text in your application’s code.

  • Context
    Descriptions or notes that provide translators with additional information about where and how the key is used, ensuring accurate translations. This is used in the AI translations as well.

  • Tags
    Custom labels that help group and categorize keys for easier filtering and management, such as homepage, error-messages, or buttons.

  • Plurals
    Support for language-specific pluralization rules, allowing translations to correctly handle singular, plural, and other forms depending on the language. Plurals are defined differently for different languages, for example English has one and other, while Russian has one, few, many, and other. This is crucial for languages that have complex pluralization rules.

    When editing a plural, different variables can be used for indicating the count variable, however we recommend using the #for this, as it provides the most flexibility and power.

    Example:

    • Other You have # new messages.
    • One You have one new message.

    When exporting the translations, different formats will handle plurals differently. For example, JSON and YAML formats will include the plural forms as separate keys, while PO files will use a different syntax.

  • Max length
    Optional character limits to prevent layout issues in your UI by warning translators if a translation exceeds the allowed length.

Creating new keys​

There are multiple ways of creating new keys. You can either create them manually from our UI, or upload content files directly if you have a larger set of translations to be imported.

Create manually​

Creating key

Import from file​

You can import keys from a file in various formats, such as JSON, YAML, or .po-files. This is useful for bulk importing translations or when you have existing translation files. If you have multiple files, you can upload them as a zip file. The system will automatically detect the file format and import the keys accordingly.