Skip to content

AI store builder and image descriptions

Both screens sit under the AI settings and share one property: they suggest, and nothing changes on your store until you review and confirm.

The screen is at /settings/ai/store-builder. It is titled Start with AI and its entry text reads: “Tell the AI what you sell. It plans pages, policies, categories and a look, and creates everything as drafts you can undo. Nothing goes live.”

It creates products and pages, so it needs both catalog.manage and cms.manage. It is also switched per store, and the screen answers as not found for a store whose switch is off. The store’s switch is on by default for stores created since 2026-10-29 and off for every older store: it is written once, when the store is provisioned, existing stores are never back-filled, and the merchant’s own AI setting overrides it either way. A platform-wide kill switch (Ai:StoreBuilderEnabled, on by default) forces every store off whatever its own switch says; while it is off, quoting, planning and applying are refused, but Undo and the reads still work. A store also needs AI itself switched on, a confirmed owner email address, and stays within a per-store daily allowance of attempts. By default the plan proposes structure only (categories, pages, policies, theme, menu) and does not invent products; products come from a list you paste.

The stages the screen shows, in order:

  1. Describe your shop — “What do you sell, and who do you sell to?” with the hint “One or two sentences are enough. Do not include personal data.” There is an alternative: “I will paste my own product list (names, prices and stock). The AI plans the rest and never sets a price.”
  2. What this will cost — Most this can cost and Usually about, in credits, with the statement “Nothing is created until you confirm.” The action is Make a plan.
  3. Review your plan — products, pages and policies, each of which can be removed, renamed or switched off with Include. The screen says “Everything is created as a draft.” and “You set prices after creating - drafts cannot be published without them.” A section What the AI assumed lists its assumptions, and claims to check are flagged.
  4. Confirm what will be created — a confirmation card stating “Nothing is created until you press the button.” and a Risk level (Low, Medium, High or Irreversible).
  5. Your drafts are ready — “Nothing is live. Open each draft to finish it and set prices.”

Undo removes the drafts. Items that were published or edited after creation are not removed; the screen lists them under Kept, not removed with the reason. A plan can be refused (“We cannot build this one”) and then nothing is created and no credits are charged.

The screen explains several reasons it may stop before planning, each with a “nothing was created or charged” statement: AI switched off for the store, no credits left, the monthly credit limit reached, the day’s builder allowance used (it “resets at midnight UTC”), and an email address that is not confirmed.

The screen is at /settings/ai/accessibility and needs settings.manage. It is titled Image descriptions and described as “Suggested descriptions for images that have none. Review each one before it is used.” It states: “These are suggestions only. Nothing changes on your store until you review a description and apply it.” A store that does not have the feature on sees “Image description suggestions are not turned on for this store.”

A batch is defined by Images (Product images or Media library) and Which images (Missing only, Missing or poor or All images). Preview cost shows how many images will be described and skipped and “About {estimate} credits, at most {max}”; the batch is started with Start suggestions. Batches show a state: Waiting, Running, Paused: out of credits, Canceled, Done or Stopped, with Cancel and Resume.

Each image shows its Current and Suggested description, with the item states Suggested, Write this one yourself, Applied, Undone, Changed since, Failed and Skipped. The actions are Accept, Edit, Decline, Apply, Undo and Save wording (“Your wording”).

The screen also reports how often suggestions needed correction. It shows a measured percentage when one exists, and otherwise a sentence saying the rate has not been measured; on the store’s own review history it says when too few suggestions have been reviewed to give a rate.