Skip to main content
Import public articles from Zendesk

How to migrate your content from a Zendesk knowledge base in minutes.

Beth-Ann Sher avatar
Written by Beth-Ann Sher
Updated over a month ago

If you want to make Intercom your single source of truth for creating and updating public articles, importing your Zendesk help content into Intercom is easy and requires no code.

Once in Intercom, you'll be able to use these articles to power Fin AI Agent and Fin AI Copilot, as well as making them accessible in the Inbox for improved self-serve performance and team efficiency.

This will attempt to migrate all of your published help articles from Zendesk. To add specific articles, we recommend copying and adding them to the Knowledge Hub in Intercom individually.

First, make sure to have Search engine indexing enabled in your Help Center settings before starting the migration. This will prevent delays in the articles being available when you search. You can do this by going to Settings > Help Center and clicking on "configure and style":

You will find the option to enable the index search under Privacy:


Get started

To start importing public articles, go to Knowledge Hub > Sources and click on Sync or Import under public articles.

Now enter your Zendesk subdomain and choose the option to “Import content” then go ahead and click Import.

Note:

  • You'll need to choose the target Help Center in Intercom if using Multi Help Center.

  • Your Zendesk articles will be converted into native public articles you can manage in Intercom.

  • There will be no sync between Zendesk and Intercom, so changes in Zendesk won’t be reflected in Intercom.

  • To import multilingual articles from Zendesk, you will need to add the additional languages in your Help Center settings, in order for the imported translations to be visible.

  • Your Intercom Help Center custom domain must be configured before the import for the redirects to be generated using the custom domain.

Now, wait for the import to complete. During this time we’ll crawl your docs site, import all of your published articles, and place them in Help Center collections that match the structure of your existing knowledge base.

This could take anywhere from a few minutes to an hour or more. We'll send you an email when it's done, so there's no need to wait around 😄

After the migration has completed, refresh the Content page in the Knowledge Hub to see your imported articles in folders on the left sidebar.

Learn how to manage public articles from the Knowledge Hub and enable them for Fin AI Agent and AI Copilot.

If you haven't already, you’ll need to turn your Help Center on or your articles won’t go live.

What is my Zendesk subdomain?

This is the domain for your Zendesk account (not your Help Center URL). Your Zendesk subdomain is its unique identifier and there are a few ways to find it which you can see here.


Uncategorized content

If you have any uncategorized content on your site, Articles will automatically create a ‘General' collection for you. Collections help your users browse and easily find what they need, so consider reorganizing these articles by topic before you publish them.


Zendesk articles redirect

Article redirects are automatically generated during the import process. While Zendesk and Intercom article and collection URLs are in different formats, this ensures that any existing links do not break after migration, preserving their SEO score.

The redirects are implemented in the form of permanent redirects (HTTP 301 responses).

Multilingual support

When importing collections and articles in multiple languages, each language variant will have its own redirect associated with the original Zendesk article URL.

Reviewing existing redirects

After the import is complete, you can review the generated redirects through the Domains section in Settings > Help Center > Configure and style:

From here, scroll down to Domains and click "manage redirects":

The panel displays the original URL and the article/collection it redirects to.

Important:

  • The redirects will only be displayed for the chosen custom domain. For instance, if you're importing articles from a Zendesk Help Center at https://support.examply.com, the redirects will appear in the domain section only if you have selected support.examply.com as your custom domain and you're using the HTTPS security protocol.

  • With Multi Help Center, redirects are not connected to a specific Help Center. Instead, they are linked to a domain. This means that redirects will show up on any Help Center that is using the same domain as the one where the Zendesk articles were located.

  • Redirects will be available for all articles that have been imported from Zendesk after September 22, 2022.


Content we don’t support yet

We’ll convert your content into formatting we support (e.g. copying images). However we don’t support the following formatting just yet:

Importing from category/collection URL's also isn't supported. You'll need to import your knowledge base from the main URL.


Articles with unsupported formatting

If there are any issues with importing your content, we'll add a Review label to the article so you can correct it before setting it live. Just open the article you need to review and read the recommendation that we’ve added. The recommendation acts as a placeholder so you’ll need to delete this and insert the content we recommend before you set the article live.


FAQs

My Help Center has articles in 2 languages but I’m only seeing one after the import?

Intercom will import all supported languages, but we will not enable that language for the Help Center. You will have to add the language in their Help Center settings, and after that the translation will be visible.

I have an article localized in EN-US and EN-GB and it imported into two different articles?

Intercom only supports a short list of localized versions of languages: Portuguese / Brazilian Portuguese, German / German (Formal), Chinese Traditional / Simplified.

For all other localized versions, we map it to the closest language supported in Intercom (ex: EN-GB, EN-US, EN-AU all map to EN). In case of a clash, we create a different article for each localized version to avoid data loss.

I have articles in Irish but they were not imported, what happened?

We only import articles in one of the supported languages by the Intercom Messenger.

The email says it imported “X” articles, but I only see “Y” in my Help Center?

The total listed in the email includes all the different languages that the article exists in. An article with translations in English, French and Portuguese will count as 3 articles in the email.


💡Tip

Need more help? Get support from our Community Forum
Find answers and get help from Intercom Support and Community Experts


Did this answer your question?