Home
/
Help Center
/
Tutorials
/
Localize your Help Center

Localize your Help Center

This tutorial will walk you through adding content in multiple languages to your Help Center. It assumes you already have at least one article that you wish to present in other languages, to serve your customers better. If you don't, follow this tutorial to create an article in English.

What you'll need:

  • article_id for the article you'd like to localize
  • Help Center content written in an additional language (German in this tutorial)
  • Help Center that is set up to support multiple locales

Once you have that, adding a locale support takes one API call:

curl --request PUT \
     --url https://api.intercom.io/articles/<article_id> \
     --header 'Intercom-Version: 2.9' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <Your access token>' \
     --header 'content-type: application/json' \
     --data '
{
  "translated_content": {
    "de": {
      "type": "article_content",
      "title": "So erstellen Sie einen Hilfeartikel",
      "body": "Eine einfache Möglichkeit, einen Artikel zu erstellen, ist die Intercom API.",
      "state": "published"
    },
    "type": "article_translated_content"
  }
}
'

You should now see the German article in your Help Center:

Translated Help Center Article

In case you decide to hide this translation from your Help Center at a later stage, update the state of the German locale from published to draft:

curl --request PUT \
     --url https://api.intercom.io/articles/<article_id> \
     --header 'Intercom-Version: 2.9' \
     --header 'accept: application/json' \
     --header 'authorization: Bearer <Your access token>' \
     --header 'content-type: application/json' \
     --data '
{
  "translated_content": {
    "de": {
      "type": "article_content",
      "state": "draft"
    },
    "type": "article_translated_content"
  }
}
'

The German version of the article will be hidden from your Help Center, while the original will remain active. Both versions will still be available for editing from inside Intercom.

Next steps