Table of Contents
Importing Your Content from Another Service
Migrate your docs from another service or via CSV! Automatic imports from Zendesk, Help Scout & more. Single/multi-language support.
Ready to bring your existing help content into HelpDocs? Good news! You have multiple options for importing your Knowledge Base ๐
This is an interactive decision guide โ please view it online.
We'll guide you to the correct import tool for you.
Just head to your account, click on Settings, then Migrations (or click here if you're logged in) and follow the steps.
You can read more about doing this over here.
You can use our blank template to move over your existing content. Use our single language CSV template as a starting point, then attach extra columns with the language code (ISO 639-1) at the end of each article row (more on that here).
Automatic Migrations from Another Service
If you're moving from a service we support, you can start a migration directly from within your HelpDocs account. Simply:
- Head to Settings > Migrations
- Choose the provider/import type
- Follow the on-screen instructions
- Review the warnings before proceeding ๐
We currently offer automatic migration tools for these platforms:
- Helpjuice
- Zendesk Guide
- Intercom Articles
- Help Scout Docs
- Readme
- ProProfs Knowledge Base
Migrations from CSV
If you have your content available as a CSV export from another platform, you can import that by head to Settings > Migrations. Your CSV file must have column headers that match the field names below exactly (including capitalization and spacing).
Single-language Migration
Importing just one language? You can download our blank CSV over here to get started.
Field Name | Description |
title required
| Title of each article. Can I migrate my data from another service? |
description required
| Description of each article. Looking to migrate your Knowledge Base from another service? Find out how here. |
body required
| Body of each article. <p>Probably! There's a bunch of places we can import from, and usually it's free</p> |
url required
| Existing URL of the article or your chosen URL for the import, which we'll also use to add redirects to your account. The article ID will be added automatically. https://docs.hosterful.com/article/my-old-article You can use a relative URL like /article/article-slug-here or an absolute URL like https://myurl.com/article/article-slug-here |
category_title required
| Title of the category the article belongs to. FAQs |
category_url required
| Existing URL of the category or your chosen URL for the import, which we'll also use to add redirects to your account. The category ID will be added automatically. https://docs.hosterful.com/category/WQsgF19Gi3-faqs You can use a relative URL like /category/category-slug-here or an absolute URL like https://docs.hosterful.com/category/category-slug-here |
category_description
| Description of the category. From app issues to common questions. Here's a list of things we get asked a lot, but don't really fit anywhere else. |
Multi-language Migration
Migrating content in multiple languages? Make sure you've enabled multilingual in your HelpDocs account first. You'll need to attach extra columns with the language code (ISO 639-1) at the end of each article row. So for example, body_de for a German body, or description_fr for a French description.
Field Name | Description |
title required
| Title of each article in your primary language. Can I migrate my data from another service? |
description required
| Description of each article in your primary language. Looking to migrate your Knowledge Base from another service? Find out how here. |
body required
| Body of each article in your primary language. <p>Probably! There's a bunch of places we can import from, and usually it's free</p> |
url
| Existing URL of the article or your chosen URL for the import in your primary language, which we'll also use to add redirects to your account. https://docs.hosterful.com/article/my-old-article You can use a relative URL like /article/article-slug-here or an absolute URL like https://myurl.com/article/article-slug-here |
category_title
| Title of the category the article belongs to in your primary language. FAQs |
category_url
| Existing URL of the category or your chosen URL for the import in your primary language. https://docs.hosterful.com/category/WQsgF19Gi3-faqs You can use a relative URL like /category/category-slug-here or an absolute URL like https://docs.hosterful.com/category/category-slug-here |
category_description
| Description of the category in your primary language. From app issues to common questions. Here's a list of things we get asked a lot, but don't really fit anywhere else. |
title_[language code] required
| Title of each article in the additional language. Kann ich meine Daten von einem anderen Dienst migrieren? |
description_[language code] required
| Description of each article in the additional language. Mรถchten Sie Ihre Knowledge Base von einem anderen Dienst migrieren? Finden Sie hier heraus wie. |
body_[language code] required
| Body of each article in the additional language. <p>Wahrscheinlich! Es gibt eine Menge Orte, von denen wir importieren kรถnnen, und normalerweise ist es kostenlos</p> |
url_[language code]
| Existing URL of the article in the additional language or your chosen URL for the import, which we'll also use to add redirects to your account. /article/my-german-article |
category_title_[language code]
| Title of the category in the additional language. Hรคufig gestellte Fragen |
category_url_[language code]
| Existing URL of the category in the additional language or your chosen URL for the import. https://support.helpdocs.io/category/WQsgF19Gi3-faqs |
category_description_[language code]
| Description of the category in the additional language. Von App-Problemen bis hin zu hรคufig gestellten Fragen. Hier finden Sie eine Liste von Dingen, die wir oft gefragt werden, die aber nicht wirklich woanders passen. |
Industry-Specific Starter CSVs
Not sure where to begin with your Knowledge Base content? We've created some starter CSV templates for different industries to help you get going quickly. Just replace the content in [brackets] with your own info!
SaaS ๐
Includes common articles about account management, billing, and feature documentation. Download CSV here.
E-Commerce ๐๏ธ
Contains templates for order tracking, returns, product information, and shipping policies. Download CSV here.
Education ๐
Features articles for course enrollment, technical support, and student resources. Download CSV here.
Logistics ๐
Includes tracking information, shipping details, and common delivery questions. Download CSV here.
Need Help With Your Migration?
Running into issues or have questions about migrating your content? Our team is here to help. Reach out to us at hi@helpdocs.io and we'll walk you through it.
What did you think of this doc?
Managing Users
