Blog & Help Center

How to move your help center from another website to TeleportHQ with ChatGPT or Claude

How to move your help center from another website to TeleportHQ with ChatGPT or Claude

In TeleportHQ, your own AI tool can move a help center you publish elsewhere, such as Intercom, Zendesk, Help Scout, Crisp, GitBook or Notion: copy the prompt below into an AI that can browse the web, such as Claude Code, Cursor or ChatGPT. It asks for your help center's web address, reads every article there, downloads every picture, writes one Markdown file per article in folders that become your categories, lists each article's old address so it keeps working, and zips the folder. Drop that ZIP on the Import Articles button in the Help Center panel, review what will be created, and your help center is live at /help, with the old addresses redirected to the new pages.

Before you start

Steps

1. Copy the prompt

Copy the whole block below. It tells the AI to find every article at your address, how to name the folders and files, what to keep from each page, where the pictures go, how to record the old addresses, and to end by zipping the folder.

You are moving my help center to TeleportHQ as Markdown files. First ask me, and wait for the answer: the web address of the help center to move (for example https://help.example.com). Ask nothing else.

Then open that address and find every article: read /sitemap.xml and /sitemap_index.xml, the home page's categories and sections, every "next" and page-number link, and every link that stays under that address, until nothing new turns up. Tell me how many articles and categories you found before you write anything.

Read every article page and write it as one Markdown file, keeping what a reader sees: the title, the text, headings, lists, tables, code blocks with their language, notes and warnings as callouts (> **Note:** …), links and pictures. Do not rewrite, shorten or improve the text.

Deliver this folder, zipped as help-center.zip:

help-center/
  01-getting-started/
    01-create-your-account.md
    02-invite-your-team.md
    pictures/
      create-your-account-1.png
  02-billing/
    _category.md
    01-change-your-plan.md

Rules:
- One folder per category of the old help center, nested like the old one (at most two levels), in the old order; one .md file per article, in the old order within its category.
- Start every folder and file name with a two-digit number and a dash. It sets the order and is removed from titles and web addresses: 02-create-your-account.md becomes "Create your account" at /help/create-your-account. Lowercase letters, digits and dashes only. Take the file name from the article's old address when it has a readable one.
- File names must be unique across all folders: each is its article's web address.
- Each article starts with front matter between two --- lines: title (the old title), description (the old summary, or one sentence that answers the question), date (the old published date, written 2026-03-15), last_verified (the old last-updated date when the page shows one), author and tags (when the page shows them), redirect_from (a list of the article's old web address paths, such as [/en/articles/123-create-your-account]), and related (the file paths of its old related articles, such as [../02-billing/01-change-your-plan.md]). No related-articles section in the body.
- Add a _category.md (name, description, order, and redirect_from with the category's old address paths) when the folder's name is not the old category's name.
- Download EVERY picture of an article, its main picture included, into the pictures folder next to it, named after the article in reading order: pictures/create-your-account-1.png, -2.png, and so on, keeping each picture's format (png, jpg, gif, webp, svg). Put each one in the text where it was: ![the picture's alt text, or one sentence saying what it shows](pictures/create-your-account-1.png).
- Link to another article of the help center with a Markdown link whose address is its file's path, relative to the current file: ../01-getting-started/02-invite-your-team.md. Keep links to other websites as they are.
- Leave out menus, headers, footers, "was this helpful" widgets, comments, cookie notices and anything else that is not the article.
- Finish by zipping the help-center folder. Then tell me how many articles and pictures you wrote, and name any page you could not read or picture you could not download.
- If you cannot download files, keep each picture's full web address in the Markdown instead, as ![alt text](https://…), and tell me at the end that the pictures stayed on the old site.

2. Give it to your AI and answer its question

  1. Open your AI tool where it can browse the web and save files: Claude Code or Cursor in an empty folder, or a ChatGPT conversation with browsing on.
  2. Paste the prompt and send it.
  3. Answer its one question with your help center's web address, for example https://help.brightly.app.
  4. Let it work. It reads the articles, downloads the pictures, writes the files, then zips the help-center folder into help-center.zip. If your tool can't make a ZIP, zip the help-center folder yourself with your computer's compress command.

3. Check the ZIP

Open the help-center folder before you import it and check:

  • The count matches: as many .md files as your old help center has articles. Open two or three and compare them with the old pages.
  • Every folder is a category and starts with a number and a dash, for example 01-getting-started. Folders can hold folders, for example 02-billing/invoices.
  • Every article starts with a title, a description and a redirect_from between two --- lines. The redirect_from paths are the old addresses without the domain, for example /en/articles/123-create-your-account.
  • Pictures sit in a pictures folder next to the articles, at the path the articles point to, for example pictures/create-your-account-1.png. If the AI said the pictures stayed on the old site, the articles point to web addresses instead; they show as long as the old site is online.
  • Every file name is different from every other, in every folder: the file name is the article's address.

4. Import it

  1. Open your project in the TeleportHQ editor.
  2. In the left sidebar, click Help Center.
  3. At the top right of the Help Center panel, click the upload arrow (tooltip Import Articles). While the list is empty, the panel also offers Import articles below Create Article.
  4. Drop help-center.zip on the box, or click the box to choose it. "Reading the file…" shows while TeleportHQ reads it.
  5. Read the plan. Nothing is written yet. It counts what the import will do, for example "48 articles", "6 categories from the folders", "120 pictures to upload to your files" and "48 old addresses to lead to their new pages, with permanent redirects". A box headed with a number of problems lists files that won't be imported, and a box of notes lists, file by file, what will be left out or changed. The messages are explained under Troubleshooting.
  6. Leave Publish imported articles on to put the articles live, or turn it off to save them as drafts.
  7. Click Import followed by the number, for example Import 48 articles. The bar shows Creating categories, Uploading pictures, then Writing articles, and a message sums it up, for example "Import finished: 48 articles added, 6 categories created, 120 pictures in your files, 48 old addresses redirected".

5. Switch the address and read it on your site

  1. Publish your site. See How to publish a web app. The redirects reach your live site when you publish; after that, new and edited articles show within seconds, without publishing again.
  2. Open /help on your site and read the articles the way a customer would. Open an old address, such as https://your-site.com/en/articles/123-create-your-account: it lands on the new page.
  3. Point your old help center's domain at your TeleportHQ site when you are ready, so the old links in emails and search results keep working. See How to connect a custom domain.
  4. For a wrong title, step or picture, fix the .md file, or ask your AI to, then zip the folder and import it again. Articles are matched by their address: a changed file updates its article in place, a new file is added, and the rest stay as they are. See Import again to update.

Check that it worked

  • The categories show as pills at the top of the Help Center panel, nested like your folders and in the order of their numbers.
  • Open an article in the panel: its pictures, links and callouts are in place.
  • In Project settings (cog, bottom left) → SEO & social → Search engines → Custom Redirects, the old addresses are listed, each leading to its new page.
  • On your live site, /help lists your categories, and each article opens at /help/ followed by its file name without the number.

Troubleshooting

The AI found far fewer articles than your help center has Some help centers list articles only behind a search or load them as you scroll, so a crawl misses them. Give the AI the address of each category page, or of the sitemap (/sitemap.xml), and ask it to continue from there. If the old platform can export your articles, give the AI the export too.

"No Markdown articles found" The ZIP holds no .md files outside left-out folders (those whose names start with _ or .). Open the ZIP and check that the articles are there and that their folders are named without a leading _ or ..

"… shares the address "…" with …; only the first is imported" Two files have the same name, in different folders. The file name is the article's address. Rename one of them, or give it its own slug in its front matter, and import again.

A note says a picture "is not in the bundle, dropped" The article points to a picture that isn't in the ZIP at that path, usually one the AI could not download. Save the picture from the old page yourself, put it next to the article at that path, and import again.

The plan says pictures are .avif (or .heic, .heif, .bmp, .tif, .tiff) "which TeleportHQ cannot upload" TeleportHQ doesn't upload pictures in those formats, so the import leaves them out of the articles. Convert them to .png, .jpg or .webp, change the picture paths in the articles to the new file names, zip the folder again and import it.

An old address still shows the old help center Redirects work on your TeleportHQ site, so the old domain has to point at it. Until you connect the old domain, test a redirect on your TeleportHQ address: the old path after your site's domain lands on the new page.

The plan counts links "to nothing in the ZIP, kept as written" A link's path matches no .md file in the ZIP. The link is kept as the AI wrote it, and after the import the editor's Issues window lists it as broken. Fix the path and import again. See How to find and fix broken links on your site.

Good to know

  • Keep the old site online until the switch is done. The AI reads it while it works, and articles whose pictures stayed on the old site keep showing from there.
  • Old addresses become permanent redirects. Each path under redirect_from becomes a permanent redirect (301) to the article's new page, and importing again keeps them up to date. A * stands for any characters: /en/articles/*-create-your-account takes every old address ending that way. See Old addresses become permanent redirects.
  • A category's old addresses need its category page. The Help Center has category pages from the start, so a redirect_from in a _category.md works right away.
  • What a re-import replaces. An article's title, text, excerpt, main picture, categories, tags, SEO title and description come from the file again, so a change you made to those in TeleportHQ is replaced. Its place in its category, related articles, status and dates change only when the file sets them. Its address never changes.
  • The Blog moves the same way. See How to move your blog from another website to TeleportHQ with ChatGPT or Claude.
Share

Related Articles

How to build your help center from your codebase with ChatGPT or Claude

In TeleportHQ, copy the prompt in this article into an AI tool that can read your code or your product notes, such as Claude Code, Cursor or ChatGPT; it writes one Markdown file per question in numbered folders and zips them, and you drop the ZIP on the Import Articles button in the Help Center panel.

How to import Markdown files into your blog or help center

In TeleportHQ, click the Import button in the Blog or Help Center panel and drop a Markdown file or a ZIP of Markdown files; folders become categories, front matter sets the title, date, order and more, pictures next to the files are uploaded, and you review a plan before anything is written.

How to add a help center to your site

In TeleportHQ, click Plugins in the editor's left sidebar, click Help Center, switch on Help Center enabled and confirm in the Activate Help Center window; TeleportHQ builds a searchable help center at /help with a page for every article and every category, and gives it its own Help Center panel.

How to move your blog from another website to TeleportHQ with ChatGPT or Claude

To move a blog from WordPress, Medium, Substack, Ghost, Squarespace, Wix or any other website into TeleportHQ, copy the prompt in this article into an AI tool that can browse the web, such as Claude Code, Cursor or ChatGPT; it finds every post through the feed and sitemap, downloads the pictures, writes one Markdown file per post with its date, author, tags, main picture and old address, and zips them for the Import Posts button in the Blog panel.

How to find and fix broken links on your site

In the TeleportHQ editor, click the yellow issues button at the top left (for example 1 issue) to open the Issues window, which lists every link on your pages, Blog posts and Help Center articles that leads nowhere, with a button that takes you to each one, even before you publish.