# AI Pages: support guide

> Current answers on AI Pages: plans, credits, building, publishing and errors.

## What it is

AI Pages builds store pages with AI inside the merchant's own Shopify theme. It builds a home page, a product page or "any page" (about, landing, campaign, FAQ, contact, size guide and similar). The AI plans the layout, writes the copy, makes the images and installs the sections into the theme. The merchant gets a new theme template (or a hidden Shopify page) to review in Shopify's theme editor. Nothing goes live until the merchant assigns, publishes or switches to it. It can also import a product from an AliExpress or CJdropshipping link and build its page.

"Set up with AI" on the Conversion Blocks page is the same feature. It opens AI Pages on a product page build with "Buy box only" checked. It's one feature, not a second tool.

## Words merchants use

All of these mean AI Pages: "AI page builder", "generate a page", "AI landing page", "Set up with AI", "AI setup", "AI Product Pages", "AI Block Setup", "AI buy box", "AI home page", "use as home page", "restore my old home page", "about page", "landing page", "import from AliExpress", "CJdropshipping", "Import from link", "builds", "builds left", "AI credits", "buy credits", "Brand guidelines", "brand colors", "In the style of", "Rhode/Seed/Spacegoods style", "Look", "Recent pages", "my AI page", "assign template".

Not AI Pages:

- "Pre-customise with AI" on a single section is section customization. It has its own credits (15 per Plus billing cycle, plus 2 per bought section). These section credits never build pages, and Plus adds no AI Pages credits. One customization uses 1 credit, or 2 with "Section images" on. Merchants often call it "Customize with AI".
- "Customize with AI" inside a bundle or the cart drawer is the AI assistant. It uses no credits. It belongs to Bundles or Cart drawer. See those docs.
- The buy-box blocks themselves are covered in the Conversion Blocks doc. AI Pages only places them.

## Plan and pricing

### Who can build

- Every store sees "AI Pages" in the app menu.
- Starting a build needs an active Plus subscription. A Plus free trial counts.
- Without it, the build window shows "AI Pages comes with Plus" and a trial or subscribe button instead of the form.
- Brand guidelines and buying credits also need an active Plus. Without it: "Brand guidelines come with Plus" and "Buying credits needs an active plan."

### Plus price and trial

- Plus costs $15/month today. Older subscribers may keep $8 or $10.
- New stores get a 14-day free trial. A store that had Plus before gets only what is left of its first trial, never a fresh one.
- The button reads "Start 14-day free trial" (new store), "Resume trial (N days left)" (returning, days left) or "Subscribe to Plus" (no trial left). Under it: "Then $15/month. Cancel anytime." or "$15/month. Cancel anytime."
- After approving Plus in Shopify, the merchant lands back in the build they started.

### Credits ("builds")

- One build uses one credit, whatever the page type or mode.
- Every store gets 5 free credits in total, once. They never reset. Reinstalling the app does not reset them.
- The 5 free credits are shared with older "Set up with AI" runs from Conversion Blocks.
- A running build holds its credit. A failed build gives it back. Only finished builds cost a credit.
- "Retry" on a failed build is a new build: one credit (the failed one came back). Retrying missing images is free.
- Sending the exact same request while it runs joins the running build. No second credit is held. Different builds can run side by side, each holding a credit.
- Bought credits never expire.
- Plus stores see "N builds left". Stores without active Plus see "N builds with Plus": credits they can use once Plus is active.
- The balance shows on the chip at the top of AI Pages, on the "Buy credits" card and at the top of the build form.
- At zero: "You're out of credits." with "Buy credits". Or: "No AI credits are available. Credits are reserved for ongoing generations. Purchase more credits to start another setup."

### Buying credits

- AI Pages → "Buy credits" (card or the builds chip).
- 5 to 100 credits per purchase, in steps of 5. Opens on 50. Quick picks: 10, 25, 50, 100.
- $1.00 per credit, with a volume discount from 10 credits up to 25% off at 100.
- A one-time charge billed through Shopify, separate from the Plus subscription.

| Credits | Discount | Total | Per credit |
|---|---|---|---|
| 5 | 0% | $5.00 | $1.00 |
| 10 | 6% | $9.40 | $0.94 |
| 25 | 11% | $22.25 | $0.89 |
| 50 | 17% | $41.50 | $0.83 |
| 75 | 21% | $59.25 | $0.79 |
| 100 | 25% | $75.00 | $0.75 |

- After approval the app says "N AI credits added!", "Processing your credits..." or "Payment declined. No credits were added."

### When Plus ends

- Cancel during the trial: Plus ends at once.
- Cancel after the trial: Plus sections keep showing until the paid period ends. But new builds and credit purchases stop at once, because the subscription is no longer active. Subscribing again inside that period starts a new subscription. Billing starts on approval, with no credit for the days already paid for.
- Unused credits stay on the store and work again when Plus is back.
- Built pages stay in the theme. The app deletes nothing.
- The sections AI Pages adds are Plus sections. Once Plus ends they stop showing to customers. The theme editor shows "This section requires an active Section Store Plus➕ subscription." The buy-box conversion blocks also need Plus (see the Conversion Blocks doc).
- The bundle widget, cart drawer and conversion blocks stop showing, and checkout gives no bundle discount or cart reward. The Shopify discounts stay listed as active and keep a slot in Shopify's limit. Subscribing again brings back whatever is still switched on. A draft bundle stays a draft until the merchant clicks "Publish".
- A frozen subscription (a payment problem) counts as ended until it is fixed.
- Still shown: the theme's own sections, sections kept from the old page, sections bought outright and the free guarantee layouts.
- A live AI home page loses most of its content. "Restore original home page" works without Plus.
- The ready window says it for live pages: "The new sections stay live while you have Plus."

## Where to find it

- App menu: "AI Pages". Three cards: "Home page" → "Build home page", "Product page" → "Build product page", "Any page" → "Build a page". Also "Recent pages", "Buy credits" and a chips row (builds count, "Recent pages", "In the style of: <name>").
- App Home: the "AI Pages" tool in the Plus card → "Plan a page", or "Build a page" once the store has built one. Both open AI Pages.
- Conversion Blocks: the "AI Product Page Setup" card has "Set up with AI". It opens a product page build with "Buy box only" checked. "Setup history" ("AI Setup History") lists only setups made before AI Pages. New builds are in "Recent pages".
- Store audit: a product page row opens a build on the store's best seller. A conversion blocks row opens "Buy box only", which starts on "Any product".
- Shopify Sidekick: "Build a product page with AI Pages" opens AI Pages for one product. "Buy box only" starts on "Any product", so pick "Specific product" to bring the product back.
- Brand guidelines: open "In the style of" on AI Pages and click "Brand guidelines". Also linked under the style choice in the build form and in the ready window's color note.

## How it works

### What the AI reads

- The chosen theme (live by default), its product template and color settings.
- Product page: the product's title, description, type, tags, options, price, metafields and first photos. Collection: its products. "Any product": a sample of the catalog.
- Home page: products and collections on the Online Store.
- Any page: the merchant's description and the products and collections it names.
- The store's style. The first build reads the theme and storefront for colors, fonts and buttons, which can add a few minutes. A password-protected store gets theme settings only.

### What it writes

- **Full product page:** a new product template. New conversion blocks in the buy box and 4 to 6 new sections below the product. Kept sections go after the new ones. Sections above the product stay.
- **Buy box only:** a new product template, a copy of the source, with new conversion blocks in the buy box. Sections above and below the product stay as they are.
- **Sections only:** a new product template, buy box unchanged, new sections below. Like a full page, it replaces what sits below the product, except the kept sections.
- In a new buy box (full page and "Buy box only"):
  - Section Store blocks already in the source are removed, including any Upsell, Sticky add to cart or Bundle block. The new blocks take their place. Those three are never added.
  - The theme's quantity selector is hidden.
  - The theme's description block is hidden if the new Tabs block shows the description.
  - The product section's background, title color and color scheme can change to match the store's colors or a preset's.
  - The gap between blocks widens if the theme leaves almost none.
  - The "Clean" look and the Seed style also round the product image corners and change the section's padding.
  - The Rhode style also hides divider blocks and makes the Add to cart button full width and uppercase.
- **Home page:** a new home template named "ai-home-<number>": hero, one collection row (or the lead product for a store with one or two products), 2 to 4 sections, sometimes an FAQ or guarantee at the end. The live home page doesn't change until "Use as home page".
- **Any page:** a page template named "ai-page-<number>" and a hidden Shopify page with a search title and description. Up to 7 sections.
- **Import from link:** a draft product (photos, short title, description, variants, prices) with its new page assigned.

Every build:

- Writes the copy: headlines, benefits, FAQs, comparisons and reviews.
- Makes images (scenes, hero, review photos) from the product's own photos and saves them to Shopify Files.
- Installs its sections into the theme. They also show in the merchant's sections list as Plus sections.
- May add one color scheme to the theme so the buy box matches the store. Existing schemes, header and footer don't change.
- Leaves existing templates and live pages alone, unless the merchant picks "Replace template".

The reviews on a page are written by the AI. Review text, reviewer names and review photos are not real customers. Rating lines, review counts and big numbers are written too. Press rows use made-up marks. Real quotes in the product description or review metafields are used with their author. Reviews inside review apps can't be read. Check every claim, number and review before going live, and swap in real reviews.

### Theme: draft vs live

- Default is the live theme. Unpublished themes can be picked under "Advanced settings" → "Theme". Development and demo themes aren't listed. Shopify demo themes are refused.
- A page on an unpublished theme stays hidden until that theme is published: "Built in <theme>, which isn't live. Customers see it once you publish that theme."

### How long it takes

- Full product page, sections only, home and any page: "Usually 3–4 minutes". Buy box only: "Usually 1–2 minutes". Imports take a few minutes more.
- The window can be closed. The build keeps going and "Recent pages" shows progress and time left.
- A running build can't be stopped.

## Step by step

### Product page

1. "AI Pages" → "Build product page".
2. Under "What do you want to build?", pick "Full product page", "Buy box only" or "Sections only". Click "Continue".
3. Under "Made for", pick "Specific product", "Collection", "Any product" or "Import from link", then "Select product" or "Select collection".
4. For a full page or sections only, tick what to keep under "Keep below the new page".
5. Optional: "In the style of", "Colors", "Look", and "Advanced settings" ("Theme", "Template name", "Start from template", "Focus").
6. Click "Generate page", "Generate buy box" or "Generate sections".
7. In "Your product page is ready", click "Open theme editor" or "Preview page".
8. Click "Assign to <product>", "Assign to the collection's products" or "Choose products".

### Home page

1. "AI Pages" → "Build home page". "Your current home page stays live until you switch."
2. Optional: style and "Advanced settings" → "Theme". Click "Generate home page".
3. Review with "Open theme editor" or "Preview page".
4. Click "Use as home page", then "Replace home page". The app saves the current home page first.
5. To go back: "Restore original home page" → "Restore".

### Any page

1. "AI Pages" → "Build a page".
2. Fill in "Describe your page": purpose, reader, products or collections to feature, and facts to include.
3. Click "Generate page". Review it in the theme editor. It stays hidden.
4. Click "Publish page". Customers find it at the path shown, for example /pages/about-us.
5. Optional: "Rename" (title and URL) and "Add to main menu".

### Import a product

1. "Build product page" → pick a mode → "Continue" → "Made for": "Import from link". A store with no products starts here.
2. Paste a full product link into "Product link". The photo, name and prices appear.
3. Set "Pricing and inventory". Remove variants you don't want.
4. Click "Generate page". Allow access if Shopify asks.
5. Click "Review product" to check it in Shopify. Add stock if you chose "Set stock manually after import".
6. Click "Publish product".

## Every choice and setting explained

### "What do you want to build?" (product pages)

- "Full product page": "Buy box and sections, with copy and images."
- "Buy box only": "New conversion blocks go in your buy box. Nothing else changes." That line is about the sections above and below the product. The product section changes too. See "What it writes".
- "Sections only": "New sections go below your product. Your buy box stays as it is."
- If the product section can't take conversion blocks, a full page continues as sections only: "Your product section can't take conversion blocks. We kept your buy box and added sections below it."

### "Made for"

- "Specific product": built from that product. The template name starts as the product's name.
- "Collection": built from the collection's products. Name starts as "collection-<name>". An empty collection is refused.
- "Any product": one template for the whole catalog, with no single product's specs. Name starts as "store-wide". No "Preview page" link. A store with one active product gets a page for it: "Built for <name>, your only product."
- The form starts on "Specific product" for a full page or sections only, and on "Any product" for "Buy box only".
- "Select product" uses Shopify's picker, which hides draft and archived products.
- "Import from link": "Import a draft product with an AI photo and page."

### "Keep below the new page"

- For full pages and sections only, not imports. Lists sections below the product in the source template that can be kept: customer reviews (Judge.me, Loox, Yotpo, Stamped, Reviews.io, Fera, Ryviu, Rivyo, Ali Reviews, Trustoo, Okendo, Junip, Opinew and apps with "reviews" in their name), "You may also like" and "Email signup".
- Ticked ones go after the new sections. Everything else below the product is left out of the new template. The old template is untouched.
- Generate waits for the check ("Checking existing sections…"). If it fails: "Couldn’t check your sections. Try again or pick another template." with "Check again".

### "In the style of"

- "Your store" (default) uses the store's own style from Brand guidelines.
- Presets: "Rhode", "Seed", "Spacegoods". Each brings that brand's layout style and its own buy box style.
- The choice is saved and reused for the next build. It can also be changed from the chip on AI Pages.

### "Colors"

- With "Your store": "Your store's colors" or "Match your product" ("Match your collection"). Product colors come from its photos, and the page gets gradient backgrounds and shiny buttons. A collection needs two photos. With no clear palette, the store's colors are used and the window says so.
- With a preset: "Your store's colors" or "<Preset>'s colors".
- Home pages, any pages, "Any product" and "Buy box only" with "Your store" always use store colors. The field is hidden.
- Automatic colors: on a theme that still has its default colors, with no colors saved in Brand guidelines, a full page for a product or collection takes its colors from the photos ("Colors inspired by your product."). On an unpublished theme we first try the live store's colors ("Using brand colors from your published store."). Saving colors with "Always use these colors" stops this. Pages that keep part of the old page ("Sections only", "Buy box only", kept sections, a custom "Start from template") keep the store's colors.

### "Look" (product pages, "Your store" style)

- "Default", "Clean", "Bold", "Luxury", "Modern", "Playful". There's no "Simple" look. Hover shows the whole buy box. Each build starts on "Default". Presets have their own buy box, so "Look" is hidden with a preset.

### "Advanced settings"

- "Theme": the live theme first, marked "Live". "We add the page as a new template. Nothing goes live until you assign it."
- "Template name" (product pages): lowercase letters, numbers and hyphens, up to 40 characters. Blank becomes "section-store". If the name exists, Generate asks: "Replace template" (products using it show the new page right away) or "Save as <name>" (keeps both).
- "Start from template": "The new template starts as a copy of this one." Default: "Current product template" for a specific product with a full page or sections only (the default template if that one isn't on the theme), else "Default product template". "Buy box only" always starts on "Default product template", so a product on a custom template needs it picked here.
- "Focus" (product and home pages): "Optional. Tone, audience or what to highlight." Up to 600 characters. It steers audience and angle only. It adds no facts. Facts come from the product in Shopify, so put them in the product description.

### "Describe your page" (any page)

- 3 to 2,000 characters. Facts in it (dates, prices, hours, policies) are used as written. Instructions shape the page and are never printed.
- It can name up to 5 products and 5 collections. A name not found in the store gets: "We couldn't find “<name>” in your store."
- It is checked before a credit is spent. Requests that aren't pages are refused for free.

### "Pricing and inventory" (import)

- "Pricing method": "Multiply supplier price", "Add a fixed amount" or "Set a fixed price".
- The first import starts at "Multiplier" 2.5 with "Round up to .99" on. Later imports reuse the last import's rule, not per-variant edits.
- "Round up to .99" needs a two-decimal currency. Fixed price ignores it.
- "Preview prices" shows "Supplier price", "Selling price" and "Profit". Selling prices can be edited per variant. A warning shows when a price is below cost.
- "Inventory": "Don't track inventory" (default) or "Set stock manually after import". "Supplier stock isn't synced."
- Prices are in the store's currency. CJdropshipping prices are converted from US dollars.
- A price preview expires after 30 minutes: "Your price preview expired. Preview prices again."

### Brand guidelines

- One set per theme ("Choose theme"). Shows eight colors: "Page background", "Main text", "Accent", "Text on accent", "Surface", "Alternate surface", "Secondary text", "Borders". Each takes a hex color.
- "Always use these colors" saves them for new pages. "Use detected colors for all" goes back to automatic. "Refresh from store" reads the store again and keeps custom colors.
- Fonts, buttons, corners and spacing are read-only.
- "Only new AI pages use these colors. Your theme and existing pages don't change."

## After the page is built

### Product pages

- "Assign to <product>" sets that product's theme template. "Assign to the collection's products" does every active product in it. "Choose products" opens Shopify's picker.
- Up to 100 products at a time. A collection with more than 100 active products opens the picker. Bigger batches: repeat, or use Shopify's bulk editor.
- Done: "Assigned to <product>" or "Assigned to N products", with "View on your store" and "Change products". "Change products" adds products. Products already assigned keep the page.
- Products added to a collection later keep their own template.
- On the live theme, a product shows the page only if the template exists in the live theme.
- A live page may show "Next · sell more per order" (cart drawer, quantity breaks). See the Cart drawer and Bundles docs.

### Home page

- "Use as home page" saves the current home page, then makes the AI page the home page. On the live theme customers see it at once. On an unpublished theme, once it's published.
- While live, theme editor edits to the home page go live.
- "Restore original home page" brings back the home page from before the first AI switch on that theme, edits and all. The AI page is kept.
- The original is also saved in the theme as the "ai-original" template. It survives an uninstall and can be previewed with ?view=ai-original.
- A new AI home page replaces a live one: "Another AI home page is live. This one replaces it." Edits to the old one are kept in its own template.

### Any page

- "Publish page" works only when the page's theme is live.
- "Rename" changes "Title" and "URL". On a published page "The old URL keeps working."
- "Add to main menu" shows after publishing. It uses the main menu, or the first menu.
- Deleted in Shopify: "This page was deleted in Shopify. Build it again to get it back."

### Imported product

- Starts as a "Draft product" with its page assigned. "Review product" opens it in Shopify. "Edit page" opens the theme editor.
- "Publish product" puts it on the Online Store and makes it active. It needs the page's theme to be live.

### Editing, retrying, removing

- Edit anything in Shopify's theme editor. "Edit template" in Recent pages opens it.
- There is no "edit with a prompt". A change by AI is a new build (one credit).
- Builds are never deleted from the app.
- Undo a product page: in Shopify, set the product's template back to the default. The app has no unassign button.
- Undo a home page: "Restore original home page".
- Undo an any page or import: unpublish or delete it in Shopify admin.
- Unused templates can be deleted in the theme. Images stay in Shopify Files until deleted there.

### Recent pages

- The latest 50 builds, newest first. A live AI home page is pinned on top.
- Statuses: "Not live yet", "Live · N products", "Live home page", "Live", "Failed", "Deleted". Running builds show "Building structure…", "Building copy…", "Building sections…" or "Building images…" with a percent and time left.
- "Live · N products" counts assignments made in AI Pages. Changes made in Shopify don't update it.
- Row actions: "Open", "Retry", "Edit template", "Assign template", "Use as home page", "Restore original home page", "Publish page".
- Assigning, publishing and restoring work without Plus. "Retry" needs Plus.

## Languages, markets and images

- Product and collection pages are written in the product's own language when the app detects it (English, German, French, Spanish, Italian, Dutch, Portuguese, Japanese, Korean or Chinese). Otherwise the store's primary language.
- Home pages, any pages, "Any product" pages and imports use the store's primary language. An import falls back to the admin language if the store's can't be read.
- Reviewer names fit the language and the store's country.
- One language per build. AI Pages doesn't translate. The copy sits in the theme, so other languages go through Shopify's Translate & Adapt.
- The AI Pages screens are in English, German, French and Spanish.
- No market settings. A page is the same in every market. Import prices use the store's currency.
- Images are saved to Shopify Files. Shopify asks for file access the first time.
- Imports read up to 12 supplier photos and pick the best four. The product then gets one AI featured photo, the best three supplier photos and any variant photos. If the AI photo fails, the best four stay. The product gets a name of up to 70 characters, a description of up to 120 words and search text. The supplier price is saved as the variant's cost.
- Any page and imported product get a search title (70 characters) and description (160). Product and home pages keep their existing search text.
- Shopify asks for file access at Generate. If the merchant declines, the page still builds with placeholders.
- Failed images don't fail the page: "1 image didn't generate. Its section shows a placeholder for now." "Retry" adds only the missing ones, for free.
- Any image can be replaced in the theme editor. AI photos can get product details wrong, so merchants should check them.

## Theme and app compatibility

- Needs an Online Store 2.0 theme (JSON templates). Older themes fail.
- "Buy box only" needs a product section that takes app blocks. A full page falls back to sections only.
- Shopify demo themes are refused. Duplicate the theme and build on the copy.
- Shopify allows 1,000 templates per theme. A full theme is refused before any credit is spent.
- Pages live in the theme they were built on. After switching themes, build again on the new one.
- Review widgets added as app embeds or inside the buy box don't show in "Keep below the new page".
- AI Pages doesn't edit pages made in other page builder apps.
- The Section Store connector for Claude or ChatGPT can't build AI pages. It handles bundles, carts and A/B tests.

## Limits and things it cannot do

- 5 free credits per store, in total. 5 to 100 credits per purchase.
- Product pages: 4 to 6 new sections. Home: hero, one collection row, 2 to 4 sections, optional closer. Any page: up to 7 sections.
- A product template holds 25 sections at most, so keeping many old ones can fail.
- Template name 40 characters. "Focus" 600. "Describe your page" 3 to 2,000.
- 100 products per assignment. 50 builds in Recent pages.
- No checkout, cart or payment pages. No collection, search or blog templates. No blog posts, emails, ads or product descriptions. No video sections.
- No editing a built page by prompt. No stopping a running build.
- No supplier stock sync or supplier orders. Imports only from AliExpress and CJdropshipping, up to 250 variants and 3 options.
- No translations or per-market versions.
- Nothing goes live without the merchant's click.

## Troubleshooting

### "AI Pages comes with Plus", "You need an active plan." or "An active subscription is required"

- Causes: no Plus; trial or subscription ended; Plus was cancelled (builds stop at once, even inside the paid period); the store is frozen or paused.
- Do: start or resume Plus from the build window. The app returns to the build.
- Contact us: Plus is active in Shopify billing but the app still says this.

### "You're out of credits." / "No AI credits are available…"

- Causes: the 5 free credits are used (older Conversion Blocks AI setups count); a running build holds a credit.
- Do: wait for running builds (a failed one returns its credit), or "Buy credits".
- Contact us: the count looks wrong, or bought credits don't show after a few minutes.

### "Generation failed. Try again." / "Something went wrong. Please try again."

- The credit comes back.
- Do: "Retry" in Recent pages. After two failures, try another theme or template.
- Contact us: three failures in a row, or the message names Shopify or a server error.

### "Our AI is slow right now. Try again in a few minutes. This didn't use a build."

- The AI provider is overloaded. Wait a few minutes and try again.

### "Check your product template" (no credit used)

- "We couldn't read <template>…": pick another template or theme.
- "…contains invalid data…": the template file is broken. Pick another, or fix it in the code editor.
- "We couldn't find a usable product section in <template>…": the template has no product section.
- "…needs a theme file that's missing (<section>)…": a section file was deleted from the theme.
- "The product section in <template> doesn't support conversion blocks…": use "Sections only", another template or a newer theme.
- Buttons: "Choose another template", "Choose another theme".

### "This theme is full"

- "This theme has 1,000 templates, Shopify's limit. Delete templates you don't use, or choose another theme." No credit used. Page builder apps that make one template per product often cause it.

### Demo or protected theme

- "AI Block Setup can't edit Shopify demo or protected themes…" or "We couldn't access the selected theme's files…". Pick the live theme, or duplicate the theme and use the copy.

### The build seems stuck

- A full page takes 3 to 4 minutes. A store's first build can take longer while it reads the store's style.
- After about 15 minutes the window says "Still building. Find it in Recent pages when it's done."
- A build that makes no progress for an hour, or never starts within 20 minutes, fails on its own and returns its credit.
- Contact us: "Building…" for more than an hour.

### "I built a page but customers don't see it"

- Product page: no product uses it ("Not live yet"). Click "Assign template".
- Unpublished theme: publish that theme in Shopify.
- Any page: "Publish page". Home: "Use as home page". Import: "Publish product".
- Plus ended: AI sections stay hidden until Plus is back.

### Assigned, but the product still shows the old page

- The template was built on a theme that isn't live, so Shopify shows the default template. Or the product's template was changed in Shopify since.
- Do: check the product's template in Shopify, and the theme named in the ready window.

### Assignment fails

- "You need permission to edit products. Ask the store owner to grant it in Shopify.": staff permissions.
- "Pick up to 100 products at a time…": choose fewer.
- Some failed ("Assigned 38 of 40 · stopped"): "Try again".

### Images missing or placeholders

- "Retry" in the ready window. Free. It fills only the spots still empty, so edits are kept.
- "Shopify needs your permission to upload images. Allow it to add the missing ones.": click "Retry" and approve file access.
- "We couldn’t add every image yet. Your template is saved. Retry the rest.": click "Retry" again. A newer build on the same template stops the old one from adding images.
- Imported products have no "Retry" here. Add images in the theme editor.
- Home: "The hero photo didn't generate. Add one in the theme editor."

### Colors look wrong

- "We couldn't find your store's colors. This page uses neutral ones.": the theme sets no readable colors.
- "Your product's photos had no clear palette. This page uses your store's colors."
- Do: set colors in Brand guidelines → "Always use these colors", then build again (existing pages don't change), or edit colors in the theme editor.
- "We couldn't read your store's style. Fix it in Brand guidelines, then retry this page.": the style scan failed or took over 6 minutes. Enter the main colors, then "Retry".
- Password-protected store: "We used your theme settings, but couldn't check the storefront."

### "Add a product first"

- "Your store has no products yet. This didn't use a build." A home page needs active products on the Online Store.
- Do: add a product, or use "Import from link".

### Any page refused (no credit used)

- "We can only build pages. Describe the page you want.": it asked for a blog post, email, ad or similar.
- "Tell us more. What is the page for?"
- "Home pages have their own builder. Use Build home page."
- "Shopify runs checkout, cart and payment. AI Pages builds pages that sell and explain."
- "We can't build this page": it needs a section AI Pages doesn't have. No "Retry" offered.
- "We don't have a <kind> section yet, so we used <section>." or "…so we left it out.": built without that part.

### Can't publish an any page or imported product

- "Publish <theme> first. This page uses its template.": publish the theme, then click again.
- "This page's theme is gone. Build the page again." / "This page's template is gone. Build the page again."
- "We need access to your pages. Try again and allow it." / "We need access to publish products. Try again and allow it."
- "We couldn't find your Online Store. Publish the product in Shopify."

### "Add to main menu" fails

- "We need access to your menus. Try again and allow it."
- "Your store has no menu to add the page to.": create a menu in Shopify.

### Home page switch or restore fails

- "We're still saving your last change. Try again in a moment."
- "We couldn't reach Shopify. Try again."
- "Shopify couldn't save this page. Your theme may be missing one of its sections."
- "This theme was deleted. Build the page on another theme." / "This page is no longer in your theme."
- Contact us: restore fails twice, or the live home page is blank.

### AI sections disappeared from the store

- Plus ended or the app was uninstalled. Plus sections and conversion blocks stop showing.
- Do: reactivate Plus. For the home page, "Restore original home page" works without Plus. After an uninstall, the old home page is in the theme as the "ai-original" template.

### My reviews aren't in "Keep below the new page"

- Only review, "You may also like" and email signup sections below the product are listed. App embeds and buy-box widgets are not.
- Do: add the review app's block back in the theme editor after the build.

### Text is in the wrong language

- The app followed the product's text language, or the store's primary language.
- Do: edit in the theme editor, or fix the product text and build again.

### Import from link errors

- "Paste a full AliExpress or CJdropshipping product link ending in .html.": open share links in a browser and copy the full product URL.
- "We couldn't read this product. Try again or choose another link."
- "This product has missing prices or unsupported variants. Choose another link."
- "Check the markup and selling prices…": positive prices with the currency's decimals.
- "Choose at least one available variant."
- "Allow access to products and files to import this product."
- "This product handle belongs to another product. Start a new import."
- Product shows "Sold out": "Set stock manually after import" was picked without adding stock.
- Retry keeps the draft, prices and inventory setting: "Your draft and prices are saved. Edit prices in Shopify."

### Buying credits fails

- "Buying credits needs an active plan.": start Plus ("View plans").
- "Prices changed. Reload the page to see the new total."
- "Shopify couldn't start the payment. Try again in a moment."

## FAQ

**Is AI Pages free?**
It comes with Plus ($15/month, 14-day free trial for new stores). Every store gets 5 builds. More cost $0.75 to $1.00 each.

**How many pages can I build?**
5 with the free credits, then as many as you buy. One credit per page.

**Do credits reset every month?**
No. The 5 free credits are once per store. Bought credits never expire.

**Do I lose a credit if a build fails?**
No. It comes back. Retrying missing images is free too.

**Is "Set up with AI" on Conversion Blocks a different tool?**
No. It opens AI Pages with "Buy box only" checked. Same credits.

**Can I use it during the free trial?**
Yes.

**I cancelled Plus but have time left. Why can't I build?**
Builds need an active subscription. Your Plus sections keep showing until the period ends, but new builds stop when you cancel.

**What happens to my AI pages if I cancel Plus?**
They stay in your theme, but their Plus sections and conversion blocks stop showing. Reactivate Plus to bring them back. For a home page, use "Restore original home page".

**Will it change my live store?**
Not on its own. You choose when to assign, publish or switch.

**Where is the page I built?**
AI Pages → "Recent pages". Click the row.

**How do I make my product page live?**
Open it from "Recent pages" and click "Assign template" or "Choose products".

**How do I put the template on hundreds of products?**
"Choose products" takes 100 at a time. For more, use Shopify's bulk editor.

**Can I go back to my old home page?**
Yes. "Restore original home page".

**Can I go back to my old product page?**
Yes. In Shopify, set the product's template back to the default. The old template never changed.

**Can I edit the page?**
Yes, in Shopify's theme editor. "Edit template" in Recent pages opens it.

**Can I tell the AI to change one part?**
No. Edit it by hand, or build a new page (one credit).

**Are the reviews real?**
No. The AI writes sample reviews, names and photos. Replace them with real customer reviews before going live.

**Which language does it write in?**
Your product's language or your store's primary language. One language per build. Translate with Shopify's Translate & Adapt.

**Can I pick the colors?**
Yes: "Your store's colors", "Match your product" or a preset's colors. Set store colors in Brand guidelines.

**Can it copy another store's design?**
It offers three preset styles: Rhode, Seed and Spacegoods. It can't copy a site you name or a screenshot.

**Does it work with my theme?**
Any Online Store 2.0 theme. "Buy box only" also needs a product section that takes app blocks.

**Can I build on an unpublished theme?**
Yes. Customers see it once that theme is published.

**Can it build a sale landing page?**
Yes. Use "Any page" and describe the sale, its dates and products.

**Can it build a checkout or cart page?**
No. Shopify runs those.

**Where do the images go?**
Into Shopify Files. Replace any of them in the theme editor.

**Does the AliExpress import place orders or sync stock?**
No. It makes a draft product with prices and photos, and builds its page.

**How long does a build take?**
About 3 to 4 minutes for a full page, 1 to 2 for buy box only. You can close the window.

**Can I cancel a running build?**
No. If it fails, the credit comes back.

**Can I delete a build?**
Not in the app. Delete the template, page or product in Shopify.

**Why is there a new color scheme in my theme?**
The app adds one so the new buy box uses your colors. Your other schemes, header and footer don't change.

**Can Claude or ChatGPT build pages through the Section Store connector?**
No. The connector handles bundles, carts and A/B tests.

**I'm not on Plus. Can I use my 5 free builds?**
Not yet. They show as "builds with Plus" and work once Plus is active.

## Contact us when

- Credits were charged but don't show after a few minutes, or the merchant asks for a refund.
- The credit balance looks wrong.
- A build fails three times in a row, or the error isn't one listed above.
- A build shows "Building…" for more than an hour.
- The live home page is blank or broken and "Restore original home page" fails.
- The merchant says AI Pages changed something they didn't approve (live home page, an existing template, header or footer).
- Plus is active in Shopify billing but the app says Plus is required.
- The merchant asks for free builds, a discount or a custom deal.
- The theme looks broken after a build or the theme editor won't load.
- Legal or policy questions about AI-written reviews or claims.

## Related articles

### Get started

- [How to use AI Pages](https://section-store.orka.help/a/135-how-to-use-ai-pages)
- [Will AI Pages change my live store?](https://section-store.orka.help/a/will-ai-pages-change-my-live-store)
- [Where are the pages I built with AI?](https://section-store.orka.help/a/find-the-pages-i-built)
- [Does AI Pages work with my theme?](https://section-store.orka.help/a/does-ai-pages-work-with-my-theme)
- [How long does an AI page take to build?](https://section-store.orka.help/a/how-long-does-an-ai-page-take)
- [What AI Pages can't do](https://section-store.orka.help/a/what-ai-pages-cant-do)
- [Can AI Pages build a checkout page?](https://section-store.orka.help/a/can-ai-pages-build-a-checkout-page)

### Product pages

- [Build a product page with AI](https://section-store.orka.help/a/125-ai-product-page-setup)
- [Build only the buy box with AI](https://section-store.orka.help/a/build-only-the-buy-box-with-ai)
- [Add AI sections below my product](https://section-store.orka.help/a/add-ai-sections-below-my-product)
- [Build one page for a whole collection](https://section-store.orka.help/a/build-a-page-for-a-whole-collection)
- [Build one page for all my products](https://section-store.orka.help/a/build-one-page-for-all-my-products)
- [Keep my reviews and other sections below the new page](https://section-store.orka.help/a/keep-my-reviews-below-the-new-page)
- [Why aren't my reviews in Keep below the new page?](https://section-store.orka.help/a/my-reviews-arent-in-the-keep-list)
- [Tell the AI what to focus on](https://section-store.orka.help/a/focus-tell-the-ai-what-to-highlight)
- [Name a template or replace an existing one](https://section-store.orka.help/a/name-or-replace-a-template)
- [Choose the template a new page starts from](https://section-store.orka.help/a/start-from-another-template)
- [Build a page on a theme that isn't live](https://section-store.orka.help/a/build-on-a-theme-that-isnt-live)
- [Why can't I find my product in Select product?](https://section-store.orka.help/a/why-cant-i-find-my-product-in-select-product)
- [Build a product page from Shopify Sidekick](https://section-store.orka.help/a/build-a-product-page-from-sidekick)
- [Where did Set up with AI and Setup history go?](https://section-store.orka.help/a/set-up-with-ai-and-setup-history)

### Assign a template

- [Assign an AI page to a product](https://section-store.orka.help/a/assign-an-ai-page-to-a-product)
- [Assign an AI page template to many or all products](https://section-store.orka.help/a/assign-an-ai-page-to-many-products)
- [Why does my product still show the old page?](https://section-store.orka.help/a/why-does-my-product-still-show-the-old-page)
- [Why couldn't I assign the template?](https://section-store.orka.help/a/why-couldnt-i-assign-the-template)

### Home page

- [Build a home page with AI](https://section-store.orka.help/a/build-a-home-page-with-ai)
- [Use my AI page as the home page](https://section-store.orka.help/a/use-my-ai-page-as-the-home-page)
- [Restore my old home page](https://section-store.orka.help/a/restore-my-old-home-page)
- [Why can't I switch or restore my home page?](https://section-store.orka.help/a/why-cant-i-switch-or-restore-my-home-page)

### Any page

- [Build an about us, contact, landing or FAQ page with AI](https://section-store.orka.help/a/build-any-page-with-ai)
- [What to write in Describe your page](https://section-store.orka.help/a/what-to-write-in-describe-your-page)
- [Publish my AI page](https://section-store.orka.help/a/publish-my-ai-page)
- [Rename an AI page or change its URL](https://section-store.orka.help/a/rename-an-ai-page-or-change-its-url)
- [Add my AI page to the menu](https://section-store.orka.help/a/add-my-ai-page-to-the-menu)
- [Why was my page description refused?](https://section-store.orka.help/a/why-was-my-page-description-refused)
- [Why can't I publish my AI page?](https://section-store.orka.help/a/why-cant-i-publish-my-ai-page)
- [Why does my AI page show a 404?](https://section-store.orka.help/a/why-does-my-ai-page-show-a-404)
- [Why was a section left out of my page?](https://section-store.orka.help/a/why-was-a-section-left-out-of-my-page)
- [Does an AI page get an SEO title and description?](https://section-store.orka.help/a/do-ai-pages-get-seo-titles)

### Import a product

- [Import a product from AliExpress or CJdropshipping](https://section-store.orka.help/a/136-how-to-import-a-product-from-aliexpress-with-ai-pages)
- [Set prices and variants for an imported product](https://section-store.orka.help/a/set-prices-for-an-imported-product)
- [Publish an imported product](https://section-store.orka.help/a/publish-an-imported-product)
- [Why did my AliExpress or CJdropshipping import fail?](https://section-store.orka.help/a/why-did-my-product-import-fail)
- [Why does my imported product show Sold out?](https://section-store.orka.help/a/why-does-my-imported-product-show-sold-out)
- [Does the import sync stock or send orders to the supplier?](https://section-store.orka.help/a/does-the-import-sync-stock-or-send-orders)

### Credits and Plus

- [How AI credits work: 15 section credits and AI Pages credits](https://section-store.orka.help/a/111-how-ai-credits-ai-features-work)
- [How many pages can I build with AI Pages?](https://section-store.orka.help/a/how-many-pages-can-i-build)
- [Buy more AI Pages credits](https://section-store.orka.help/a/buy-more-ai-pages-credits)
- [What uses a credit and when does it come back?](https://section-store.orka.help/a/what-uses-a-credit-and-when-it-comes-back)
- [Why can't I build a page? It says I'm out of credits](https://section-store.orka.help/a/why-does-it-say-im-out-of-credits)
- [I bought credits but they don't show](https://section-store.orka.help/a/i-bought-credits-but-they-dont-show)
- [Do I need Plus for AI Pages?](https://section-store.orka.help/a/do-i-need-plus-for-ai-pages)
- [I cancelled Plus. Why can't I build?](https://section-store.orka.help/a/i-cancelled-plus-why-cant-i-build)
- [What happens to my AI pages when Plus ends?](https://section-store.orka.help/a/what-happens-to-my-ai-pages-when-plus-ends)
- [Why did my AI sections disappear from my store?](https://section-store.orka.help/a/why-did-my-ai-sections-disappear)
- [What happens to my AI pages if I uninstall the app?](https://section-store.orka.help/a/what-happens-to-my-ai-pages-if-i-uninstall)

### Style and colors

- [Use a preset style with In the style of](https://section-store.orka.help/a/use-a-preset-style-in-the-style-of)
- [Choose the colors of an AI page](https://section-store.orka.help/a/choose-the-colors-of-an-ai-page)
- [Choose a Look (design style) for the buy box](https://section-store.orka.help/a/choose-a-look-for-the-buy-box)
- [Set my colors in Brand guidelines](https://section-store.orka.help/a/set-my-colors-in-brand-guidelines)
- [Why are the colors on my AI page wrong?](https://section-store.orka.help/a/why-are-the-colors-on-my-ai-page-wrong)
- [Fix the "We couldn't read your store's style" error](https://section-store.orka.help/a/we-couldnt-read-your-store-style)
- [Why is there a new color scheme in my theme?](https://section-store.orka.help/a/why-is-there-a-new-color-scheme-in-my-theme)
- [Can AI Pages copy another website?](https://section-store.orka.help/a/can-ai-pages-copy-another-website)
- [Use AI Pages on a password-protected store](https://section-store.orka.help/a/ai-pages-on-a-password-protected-store)

### After the build

- [Edit a page after it's built](https://section-store.orka.help/a/edit-a-page-after-its-built)
- [Undo an AI page](https://section-store.orka.help/a/undo-an-ai-page)
- [Delete an AI page](https://section-store.orka.help/a/delete-an-ai-page)
- [Are the reviews on my AI page real?](https://section-store.orka.help/a/are-the-reviews-on-my-ai-page-real)
- [The AI wrote something wrong on my page](https://section-store.orka.help/a/the-ai-wrote-something-wrong-on-my-page)
- [Where do the images on my AI page come from?](https://section-store.orka.help/a/where-do-ai-page-images-come-from)
- [Why are images missing on my AI page?](https://section-store.orka.help/a/images-missing-on-my-ai-page)
- [Which language does AI Pages write in?](https://section-store.orka.help/a/which-language-does-ai-pages-write-in)
- [Why is my AI page in the wrong language?](https://section-store.orka.help/a/why-is-my-ai-page-in-the-wrong-language)
- [Translate an AI page](https://section-store.orka.help/a/translate-an-ai-page)

### Troubleshooting

- [Why can't customers see my AI page?](https://section-store.orka.help/a/why-cant-customers-see-my-ai-page)
- [Why did my AI page build fail?](https://section-store.orka.help/a/why-did-my-ai-page-build-fail)
- [My AI page build seems stuck](https://section-store.orka.help/a/my-ai-page-build-seems-stuck)
- [What does "Our AI is slow right now" mean?](https://section-store.orka.help/a/our-ai-is-slow-right-now)
- [Fix the "Check your product template" error](https://section-store.orka.help/a/fix-check-your-product-template)
- [Fix the "This theme is full" error](https://section-store.orka.help/a/fix-this-theme-is-full)
- [AI Pages can't edit demo or protected themes](https://section-store.orka.help/a/ai-pages-cant-edit-demo-or-protected-themes)
- [Fix the "Add a product first" message](https://section-store.orka.help/a/fix-add-a-product-first)
- [Why did AI Pages keep my old buy box?](https://section-store.orka.help/a/why-did-ai-pages-keep-my-old-buy-box)
- [Why did my quantity selector disappear?](https://section-store.orka.help/a/why-did-my-quantity-selector-disappear)