React Components for internationalization.

Primary LanguageJavaScriptOtherNOASSERTION

React Intl

Internationalize React apps declaratively. This library provides React components and an API to format dates, numbers, and string messages, including pluralization.

npm Version Build Status Dependency Status


An overview and discussion of React Intl v2 can be found in #162

React Intl is part of FormatJS, the v1 docs can be found on the website:



  • Display numbers with separators.
  • Display dates and times correctly.
  • Display dates relative to "now".
  • Pluralize labels in strings.
  • Support for 150+ languages.
  • Runs in the browser and Node.js.
  • Built on standards.


There are many examples on the website, but here's a hello world one:

import React, {Component} from 'react';
import ReactDOM from 'react-dom';
import {IntlProvider, FormattedNumber, FormattedPlural} from 'react-intl';

class App extends Component {
    constructor(props) {
        this.state = {
            name       : 'Eric',
            unreadCount: 1000,

    render() {
        const {name, unreadCount} = this.state;

        return (
                Hello <b>{name}</b>, you have {' '}
                <FormattedNumber value={unreadCount} /> {' '}
                <FormattedPlural value={unreadCount}

    <IntlProvider locale="en">
        <App />

This example would render: "Hello Eric, you have 1,000 messages." into the container element on the page.

CLDR pluralization rules: In some languages you have more then one and other. For example in ru there are the following plural rules: one, few, many and other. Check out the official CLDR documentation from unicode.org http://www.unicode.org/cldr/charts/27/supplemental/language_plural_rules.html for all languages.

Note: You could also write =0 { No comments yet }


Let's make React Intl and FormatJS better! If you're interested in helping, all contributions are welcome and appreciated. React Intl is just one of many packages that make up the FormatJS suite of packages, and you can contribute to any/all of them, including the Format JS website itself.

Check out the Contributing document for the details. Thanks!


This software is free to use under the Yahoo Inc. BSD license. See the LICENSE file for license text and copyright information.