Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Plurals

Plural forms in i18next: the _one, _other and other CLDR suffixes per language, ordinal plurals, interval plurals and the count option.

Plural can be combined with interpolation, context, ...

These plurals are streamlined with the one used in the Intl API. =>In environments without Intl.PluralRules support you need to polyfill it (notably React Native: the Hermes engine still does not implement Intl.PluralRules). Since i18next v24 there is no fallback: without Intl only English-style _one/_other forms resolve.

If you need multiple counts, take a look at nesting

We provide the ability to have special translation for {count: 0}, so that a more natural language can be used. If the count is 0, and a _zero entry is present, then it will be used instead of the language plural suffix.

🎓 Check out this topic in the i18next crash course video.

Singular / Plural

keys

{
  "key_one": "item",
  "key_other": "items",
  "keyWithCount_one": "{{count}} item",
  "keyWithCount_other": "{{count}} items"
}

sample

i18next.t('key', {count: 0}); // -> "items"
i18next.t('key', {count: 1}); // -> "item"
i18next.t('key', {count: 5}); // -> "items"
i18next.t('key', {count: 100}); // -> "items"
i18next.t('keyWithCount', {count: 0}); // -> "0 items"
i18next.t('keyWithCount', {count: 1}); // -> "1 item"
i18next.t('keyWithCount', {count: 5}); // -> "5 items"
i18next.t('keyWithCount', {count: 100}); // -> "100 items"
i18next.t($ => $.key, {count: 0}); // -> "items"
i18next.t($ => $.key, {count: 1}); // -> "item"
i18next.t($ => $.key, {count: 5}); // -> "items"
i18next.t($ => $.key, {count: 100}); // -> "items"
i18next.t($ => $.keyWithCount, {count: 0}); // -> "0 items"
i18next.t($ => $.keyWithCount, {count: 1}); // -> "1 item"
i18next.t($ => $.keyWithCount, {count: 5}); // -> "5 items"
i18next.t($ => $.keyWithCount, {count: 100}); // -> "100 items"

Languages with multiple plurals

Sample uses arabic which has 5 plural forms beside the singular.

keys

sample

When a plural form is missing

Since v27.1.0, when the form selected for count is missing, i18next uses the _other form of the same language before it moves on to the fallback language, as CLDR does (lateral inheritance). Within one language the order is key_<form>, then the plain key, then key_other. With a context, key_<context>_other comes before key_other; with ordinal, the last one is key_ordinal_other. A defaultValue_other is used the same way, after defaultValue.

This matters for French, Spanish, Italian and Portuguese: current CLDR data gives them a many form for exact millions, so files with only _one and _other miss it.

A form that is filled in from _other is not reported as missing at runtime (saveMissing, missingKeyHandler, exists()).

How to find the correct plural suffix?

You can use this small utility to get the correct plural suffixes.

source code

Or try translation-check, it shows an overview of your translations in a nice UI. It shows also the appropriate plural forms.

Or you use a smart translation management system, like locize

Ordinal plurals

There is also support for ordinal numbers (referring to the ordering or ranking of things, e.g. "1st", "2nd", "3rd" in English). The ordinal option (and the _ordinal suffix) tells the helper to use the ordinal digit to determine the plurality key used. E.g., for "32" the ordinal digit is "2" so key_two is used.

keys

sample

Interval plurals

Want to define phrases expressing the number of items lies in a range. Like a few items or a lot of items.

You will need to add a post processor: i18next-intervalplural-postprocessor

keys

sample

Last updated