Plenty of founders start their help center as a public Notion page. It's fast and free, and it stops working once customers need search, a proper domain, answers in the product, and articles that don't go stale. Here's how to move.

What moves

  • Pages under a parent page. Every page under the Notion page you choose becomes a draft article, with text, headings, lists, quotes, and code.
  • A fresh structure. Imported pages land together; arrange them into collections in the usedocs content tree.
  • Public URLs, with the website import. If your Notion help pages are public on a site, the website import can read them from that URL, keep images and simple tables, and redirect old paths on a domain you control.

Steps

  1. Connect Notion. In the usedocs dashboard, open Integrations, connect Notion, and give usedocs access to the page that holds your help docs.
  2. Choose the parent page and import. Pick the Notion page in usedocs and start the import. Each page under it arrives as a draft article.
  3. Organize and review. Group the drafts into collections, tidy formatting, re-add images, and publish.
  4. Add the assistant and connect GitHub. Turn on Ask AI on the help center so readers can ask in their own words, and install the GitHub app so merged pull requests propose edits.
  5. Publish on your domain. Serve the help center on your own domain or a subfolder of your site, and replace links to the old Notion pages in your app and emails.

After the import

A Notion page doesn't know when your product changes or what customers couldn't find. Once the pages are articles in usedocs, the assistant answers customers from them with sources, and every question it couldn't answer becomes a ranked gap with a drafted article. Connect GitHub and merged pull requests propose edits to the articles they affect. What used to be a page you occasionally remember to update becomes a help center that tells you what to fix.

Good to know

  • The Notion import brings text, headings, lists, quotes, and code; images, databases, and embeds need re-adding.
  • Notion imports create no redirects; links to notion.site pages can't be redirected.
  • Up to 100 articles per import run.
  • Notion stays the place for internal notes; usedocs is for the customer help center.