How to move your shop's products from another website to TeleportHQ with ChatGPT or Claude
In TeleportHQ, your own AI tool can move the products of a shop you run elsewhere, such as Shopify, WooCommerce, Wix, Squarespace or Etsy: copy the prompt below into an AI that can browse the web, such as Claude Code, Cursor or ChatGPT. It asks for your shop's web address, finds every product, reads each product page, downloads every product photo, writes a products.csv file (or products.json when the shop has variants) with the photos in a folder beside it, and zips the folder. Drop that ZIP on the Import Products panel in the E-Commerce panel, check the preview, and click Import: the products are added to your store with their photos uploaded to your files.
Before you start
- Your project needs the store switched on. See How to add a store to an existing project.
- 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 shop must be online and public while the AI reads it.
- A Shopify shop can skip the AI: export your products as a CSV file in your Shopify admin and import that file as it is, variants included. See How to import products from a file (including Shopify).
- Every product needs at least a name and a price. Everything else is optional. The columns the import reads are listed in How to import products from a file (including Shopify), and the prompt below tells the AI all of it.
Steps
1. Copy the prompt
Copy the whole block below. It tells the AI to find every product at your address, what to read on each product page, where the photos go, how to write the products file, and to end by zipping the folder.
You are moving my shop's products to TeleportHQ. First ask me, and wait for the answer: the web address of the shop to move (for example https://shop.example.com). Ask nothing else.
Then open that address and find every product: read /sitemap.xml and /sitemap_index.xml (a products sitemap when there is one), the collection and category pages, every "next" and page-number link, and every link under that address that opens a product page, until nothing new turns up. Tell me how many products and categories you found before you write anything.
Read every product page and take what a shopper sees: the name, the price with its currency, the description (as plain text, or simple HTML with paragraphs, lists and bold), the options and variants with their own prices when the page shows them (sizes, colours), the categories or collections it is in, the SKU, the stock when shown, and every photo. Do not rewrite, shorten or improve the descriptions.
Deliver this folder, zipped as products.zip:
products/
products.csv
pictures/
black-bird-feathers-1.jpg
black-bird-feathers-2.jpg
desert-warrior-1.jpg
Rules:
- One products.csv at the top of the folder, one row per product, with this header: name, price, currency, description, status, category, slug, sku, quantity, brand, image_url, image_alt, gallery_images. Leave a cell empty when the page shows nothing for it. Use a comma between cells, put a cell that holds a comma, a quote or a line break between double quotes, and double every quote inside it.
- price is a number only, such as 550.00, and currency its three-letter code, such as RON, EUR or USD. status is active for a product on sale, inactive for one the shop marks sold out or unavailable. category is the product's first category name; slug is the last part of its old web address, lowercase, dashes only.
- Download EVERY photo of a product into the pictures folder, named after the product: pictures/black-bird-feathers-1.jpg for the main photo, then -2.jpg, -3.jpg, and so on in the order the page shows them, keeping each photo's format (jpg, png, webp). image_url is the main photo's path, pictures/black-bird-feathers-1.jpg; image_alt is what it shows; gallery_images is the other photos' paths as a JSON list in one cell, "[""pictures/black-bird-feathers-2.jpg"",""pictures/black-bird-feathers-3.jpg""]".
- When products have variants (sizes, colours, materials with their own prices or stock), write products.json instead of products.csv: a JSON list of products with the same fields, gallery_images as a normal list, and variants as a list of objects with their option values, price, sku, quantity and image_url.
- Leave out menus, headers, footers, reviews, "you may also like" boxes, shipping and returns text and anything else that is not the product.
- Finish by zipping the products folder. Then tell me how many products and photos you wrote, and name any page you could not read or photo you could not download.
- If you cannot download files, put each photo's full web address in image_url and gallery_images instead, and tell me at the end that the photos 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 shop's web address, for example
https://shop.brightly.app. - Let it work. It reads the product pages, downloads the photos, writes
products.csv(orproducts.json), then zips theproductsfolder intoproducts.zip. If your tool can't make a ZIP, zip theproductsfolder yourself with your computer's compress command.
3. Check the ZIP
Open the products folder before you import it and check:
- The count matches: as many rows in
products.csv(or items inproducts.json) as your old shop has products. Open the file in a spreadsheet and compare a few rows with the old pages: name, price, currency, description. - Every product has a name and a price. A row without them is skipped by the import.
- Photos sit in the
picturesfolder, at the paths the file points to, for examplepictures/black-bird-feathers-1.jpginimage_url. If the AI said the photos stayed on the old site, the cells hold web addresses instead; they show as long as the old shop is online. - The file is at the top of the folder, next to
pictures, and there is only one products file in the ZIP.
4. Import it
- Open your project in the TeleportHQ editor.
- In the left sidebar (the icon column), click E-commerce (the card icon). The E-Commerce panel opens.
- Next to Products, click More actions (the … button, left of +), then Import Products.
- In the Import Products panel, under Import from File, drag
products.ziponto the drop box, or click the box to choose it. - Check the file review. TeleportHQ shows the file name and type, a note such as 12 pictures from the ZIP will be added to your files with the products (followed by how many pictures in the ZIP no product uses, and any picture path a product names that is not in the ZIP), any errors and warnings, and a preview list of the products. If the AI's column names differ from the expected ones, TeleportHQ works out the columns with AI on its own and says so above the preview.
- Click Import [number] Products, for example Import 33 Products.
- Wait while the photos are uploaded to your files and the products are added. With variants, Linking variants counts up after the products.
5. Check the products and switch the address
- In the Products list, open a few products and check the prices, descriptions, photos and variants. The photos are in your files, in the store's folder, so the old shop can go offline.
- Put the products on your pages and publish. See How to show products on your pages and How to publish a web app.
- Point your old shop's domain at your TeleportHQ site when you are ready. See How to connect your own domain. The import doesn't add redirects from the old product addresses; add the ones that matter in Project settings (cog, bottom left) → SEO & social → Search engines → Custom Redirects.
Check that it worked
The message "Successfully imported 33 products" appears (with "(2 failed)" if some couldn't be added), the panel closes, and the products are in the Products list with their photos. In the Assets Manager, the photos are in the store's folder of your Public files.
Troubleshooting
The AI found far fewer products than your shop has Collection pages often load more products as you scroll, so a crawl stops early. Give the AI the address of the products sitemap (on Shopify, /sitemap_products_1.xml) or of each collection page, and ask it to continue from there. If the old platform can export your products, give the AI the export too, or import the export directly.
"Unsupported file type" The ZIP holds no .csv or .json file at its top, or holds a file in another format. Open the ZIP: the products file must be products.csv or products.json next to the pictures folder.
A photo is listed as missing A product points to a photo that isn't in the ZIP at that path, usually one the AI could not download. Save the photo from the old page yourself, put it in the pictures folder under that name, and import again. The product is still imported, without that photo.
"The AI could not map this file to our product fields." or "The AI produced a mapping but no valid products. Check that the file contains product data." The file has no product rows, or no names and prices. Open products.csv, check that the header has name and price and that the rows hold them, and try again.
Products show up twice, with "(1)" after the name The import always adds new products. It doesn't update products that already exist, so a product whose name is already in your store gets a number added. Delete the copies, or import only the new rows.
Prices are off by a hundred, or in the wrong currency The AI read "550.00" as "55000", or took the price's symbol for another currency. Fix the price and currency cells in the file and import again, after deleting the wrong products.
Good to know
- Photos in the ZIP are uploaded to your files; web addresses stay web addresses. A photo given by its path in the ZIP is uploaded once to the store's folder of your Public files and attached to the product, so it stays with your store. A photo given by a web address is saved as that address, so the link must stay public and online.
- Shopify exports work as they are. A CSV exported from Shopify is read directly, variants included; the AI prompt is for shops that can't export, or whose export TeleportHQ doesn't recognise. See How to import products from a file (including Shopify).
- Unknown column names are worked out with AI. When the file's columns don't match the expected names, TeleportHQ maps them with AI, which uses AI tokens from your workspace. See What uses AI tokens, and how much?
- Orders, customers and reviews don't move. The import brings the products: their names, prices, descriptions, categories, variants and photos.
- The help center and the blog move the same way. See How to move your help center from another website to TeleportHQ with ChatGPT or Claude.