Importing from HelpScout
Like the Intercom importer, this connects live to the Help Scout Docs API. Unlike Intercom, you can optionally limit the import to just one collection instead of pulling in everything.
Getting an API key#
In Help Scout, click your avatar (top-right) → Your Profile → Authentication → API Keys, and copy your Docs API key.
The key is used only for this one import request and is never saved to your database.
Running the import#
Go to WP Super Docs → Import, choose Help Scout as the source, and fill in:

- API key: your Help Scout Docs API key.
- Assign to product: which existing WP Super Docs product every imported article goes under.
- Collection ID (optional): paste a specific collection’s ID (found in its Help Scout URL) to import only that collection. Leave blank to import every collection in the account.
- Include unpublished: checked to also import articles that aren’t published yet, as WordPress drafts.
- Duplicate handling: skip anything whose slug already exists, or update existing docs whose slug matches.
Click Import from Help Scout.
How the structure maps over#
Help Scout’s own hierarchy is Collection → Category → Article. Since WP Super Docs only has one level of categorization, Help Scout’s Categories become WP Super Docs categories directly, a clean one-to-one mapping, and articles become docs with their HTML body carried over as-is. The top-level Collection itself isn’t represented separately in WP Super Docs, it’s just the grouping the import loops through.
If an article has more than one category#
Help Scout allows an article to belong to more than one category at once. Only the first matching category is carried over, any additional categories that same article belongs to in Help Scout are silently dropped. If you rely on multi-category organization in Help Scout, check imported articles afterward and add any additional categories manually.
Scale and rate limits#
Each article requires two API calls (one to list it, one to fetch its full content), so a large collection takes proportionally longer to import than the same-sized weDocs migration. Help Scout’s own API rate limit is 2,000 requests per 10 minutes; if you hit it mid-import, wait a few minutes and run the import again; anything already imported is safely skipped or updated rather than duplicated, depending on your Duplicate handling choice.
What isn’t preserved#
Matching for updates is by slug only, the same limitation as the other importers: if an article’s slug changes on the Help Scout side between imports, it won’t be recognized as the same article and will be created again instead of updated.
Was this helpful?
Thanks for your feedback!
✓ Feedback received. Thank you!