Overview

UserGuiding's Zendesk Migration feature makes it simple to import your published Zendesk articles into the UserGuiding Knowledge Base. Follow the steps below for a smooth transition.

Preparing Your Zendesk Knowledge Base for Migration

Before starting, complete the following steps to ensure your Zendesk Help Center is ready for a seamless migration:

• In your UserGuiding Knowledge Base, you can configure the Custom Domain and enable/disable the Search Engine Indexing. This way, all articles will be searchable in UserGuiding after migration, depending on your preferences.
• Ensure that all your articles are organized correctly in Zendesk categories and sections. This will help retain the structure within UserGuiding.

The Migration Process

To initiate the migration from Zendesk to UserGuiding:

• Go to Knowledge Base > Articles in UserGuiding.
• Click on the Import icon.
• Select Import from Zendesk.

• Enter your Zendesk subdomain. Your Zendesk subdomain is a unique identifier for your account. It’s typically the part of your Zendesk account URL that appears before “zendesk.com.” You can find your Zendesk subdomain here.

• Click Migrate to begin the import process.
• UserGuiding will verify the provided Zendesk subdomain before beginning the import.
• The system will gather and import all published Zendesk articles, maintaining the content structure as closely as possible.

The duration of the migration can vary depending on the number of articles and the complexity of your content. Once the process is complete, you will receive an email notification.

Note: If you receive an error indicating the subdomain is not found, ensure there are no active redirects on your Zendesk subdomain. Disable any redirects before trying again.

• Once the migration is finished, go to Categories & Articles in UserGuiding to view your imported content.

Note: There is no need to adjust URLs or set up redirects, as UserGuiding automatically generates the necessary redirects to ensure that all internal links are preserved.

How Content is Organized in UserGuiding

UserGuiding will import your Zendesk content and organize it according to the structure in your Zendesk Help Center:

• Categories in Zendesk will be imported as Categories in UserGuiding.
• Sections and Subsections in Zendesk will be converted to Subcategories.
• Articles will be placed within their corresponding categories and subcategories.

Important Notes

• Only published articles that are public will be migrated from Zendesk to UserGuiding. To import specific articles, we recommend manually copying and pasting them into the UserGuiding Knowledge Base.
• UserGuiding doesn't offer real-time syncing. Once the migration is complete, any changes made in Zendesk Knowledge Base will not be reflected in UserGuiding.
• UserGuiding supports all languages Zendesk provides, as long as they’re enabled in your UserGuiding account. If your Zendesk Help Center has articles in multiple languages, ensure these languages are also added in UserGuiding > Localization and Knowledge Base Languages. This will enable your multilingual content to be displayed correctly after migration.