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
- Your project needs the Help Center switched on. See How to add a help center to your site.
- You need an AI tool that can open web pages and save files: for example Claude Code or Cursor, or ChatGPT with browsing. The old help center must be online and public while the AI reads it.
- The ZIP must hold one folder per category, with one
.mdfile per article and the pictures next to them; a number at the start of each folder and file name sets its order. The full format is in How to import Markdown files into your blog or help center, and the prompt below tells the AI all of it. - To write the help center from your product instead of from an old site, see How to build your help center from your codebase with ChatGPT or Claude.
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: .
- 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 , and tell me at the end that the pictures stayed on the old site.2. Give it to your AI and answer its question
- 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.
- Paste the prompt and send it.
- Answer its one question with your help center's web address, for example
https://help.brightly.app. - Let it work. It reads the articles, downloads the pictures, writes the files, then zips the
help-centerfolder intohelp-center.zip. If your tool can't make a ZIP, zip thehelp-centerfolder 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
.mdfiles 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 example02-billing/invoices. - Every article starts with a
title, adescriptionand aredirect_frombetween two---lines. Theredirect_frompaths are the old addresses without the domain, for example/en/articles/123-create-your-account. - Pictures sit in a
picturesfolder next to the articles, at the path the articles point to, for examplepictures/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
- Open your project in the TeleportHQ editor.
- In the left sidebar, click Help Center.
- 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.
- Drop
help-center.zipon the box, or click the box to choose it. "Reading the file…" shows while TeleportHQ reads it. - 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.
- Leave Publish imported articles on to put the articles live, or turn it off to save them as drafts.
- 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
- 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.
- Open
/helpon your site and read the articles the way a customer would. Open an old address, such ashttps://your-site.com/en/articles/123-create-your-account: it lands on the new page. - 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.
- For a wrong title, step or picture, fix the
.mdfile, 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,
/helplists 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_frombecomes 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-accounttakes 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_fromin a_category.mdworks 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.