# Import from Zendesk Guide

> Paste your Zendesk help center address: articles, categories, images and attachments come across and every old /hc/ link redirects to its new page.

URL: https://office.greatwork.company/kb/features/zendesk-import
Last updated: 2026-11-21

Bring your Zendesk Guide articles, categories, images and attachments across yourself, with every old link redirecting to its new page.

## What comes across

Categories and sections (sections become subcategories), articles with their formatting, drafts, labels (as keywords), promoted articles (as featured), and the original created and updated dates. Every inline image and attachment is downloaded and re-hosted, so nothing still loads from Zendesk.

## Links and rankings

Links between your articles are rewritten to point at the new ones. Every old address pattern (`/hc/en-us/articles/360012345678-Title`, sections and categories) gets a redirect matched by its id, so the title part of the old link doesn't matter. Point your old help center domain at us and Google follows the redirects.

## A dry run first

Before anything is imported you get a report: counts, and warnings such as "3 articles use embeds we don't support" or "12 articles are restricted to a user segment and will come across as team only". Restricted articles never come across as public. Then you click Import and watch it run.

## Run it again

The import matches articles by their Zendesk id, so running it again updates instead of duplicating. Useful if your team keeps writing in Zendesk until switch day.

## Example: 480 articles on a Tuesday afternoon

A support team pastes `support.example.com`. Their public articles need no credentials; they add an API token so the 12 restricted articles come too. The dry run lists 480 articles, 1,034 images and 3 warnings. They import, check the three flagged articles, set up help.example.com and switch DNS. Old links from customer emails land on the right articles.

## How to set it up

1. Open Settings, then Import, and choose Zendesk Guide.
2. Paste your help center address. Add an email and API token if you have restricted content.
3. Read the dry run report, then click Import.
4. Point your old help center domain at us so old links redirect.

## Questions

### Can I import from Help Scout Docs or Intercom Articles?

Not with a one-click importer yet; those are next. Until then the API accepts articles as Markdown or HTML, and redirect rules handle the old links.

### Does Zendesk need to stay active?

Only until the import finishes. After that everything lives with us, images included.

---

Office by Great Work. Questions or corrections: hello@greatwork.company
