Products

How to move your shop's products from another website to TeleportHQ with ChatGPT or Claude

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

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

  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 shop's web address, for example https://shop.brightly.app.
  4. Let it work. It reads the product pages, downloads the photos, writes products.csv (or products.json), then zips the products folder into products.zip. If your tool can't make a ZIP, zip the products folder 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 in products.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 pictures folder, at the paths the file points to, for example pictures/black-bird-feathers-1.jpg in image_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

  1. Open your project in the TeleportHQ editor.
  2. In the left sidebar (the icon column), click E-commerce (the card icon). The E-Commerce panel opens.
  3. Next to Products, click More actions (the … button, left of +), then Import Products.
  4. In the Import Products panel, under Import from File, drag products.zip onto the drop box, or click the box to choose it.
  5. 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.
  6. Click Import [number] Products, for example Import 33 Products.
  7. 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

  1. 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.
  2. Put the products on your pages and publish. See How to show products on your pages and How to publish a web app.
  3. 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.
Share

Related Articles

How to import products from a file (including Shopify)

To import products into a TeleportHQ store, open the E-Commerce panel, click More actions (…) → Import Products next to Products and drop any product list (CSV, Excel, JSON, text, or a ZIP with the pictures); a Shopify export works as it is, other files are read with AI, and you can check and change each product before you click Import.

How to export your products

To export all products from a TeleportHQ store, open the E-Commerce panel, click More actions (…) → Export Products next to Products, choose CSV or JSON and click Export; product export works on Trial, Pro and Premium workspaces.

How to add product photos and 3D models

In the TeleportHQ product form, click Add Image under Product Images (or drop pictures from your computer onto it) to add photos up to 5 MB, set the main photo with Make Main, and click Save Changes; under 3D Model, click Add 3D model to upload a .glb file up to 30 MB or pick a free model from a 3D library.

How to add sizes, colors and other variants

To sell a TeleportHQ store product in sizes, colors or other variants, open the product, click Variants under More ways to sell it, add up to 3 variant options with their values, set a price, stock and SKU for each combination, and click Save Changes.

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

To move a help center from Intercom, Zendesk, Help Scout, Crisp, GitBook, Notion 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 reads every article at the address you give it, downloads the pictures, writes one Markdown file per article in folders that become your categories with the old addresses as redirects, and zips them for the Import Articles button in the Help Center panel.

What can't the TeleportHQ store do yet?

The TeleportHQ store sells physical and digital products, subscriptions and gift cards through seven payment providers, but it can't yet connect Adyen, Checkout.com, Paystack, Flutterwave, PayU, Fiserv or Antom, import products straight from Shopify, Wix or other platforms (file import works), use live carrier rates or a tax service, or keep separate test keys for staging.