A Gatsby theme for providing localization support via react-intl. This theme sets up react-intl’s context provider so that you can access your translations on every page.


  1. Install the theme and its peerDependencies.
npm install gatsby-theme-i18n-react-intl react-intl
  1. Add the configuration to your gatsby-config.js file:
module.exports = {
  plugins: [
      resolve: `gatsby-theme-i18n-react-intl`,
      options: {
        defaultLocale: `./i18n/react-intl/en.json`,


Place your <locale>.json files inside the directory you pointed to with defaultLocale.

You can also see an official example to learn more.

Theme options

Key Default Value Description
defaultLocale none The default locale. Place your other locale files as siblings into the same directory