Skip to content

The store builder is where you design what shoppers see: the home page, product and collection pages, the cart, checkout, and any extra pages you add. Each page is made of sections (a hero banner, a product grid, an FAQ) and each section holds blocks (a heading, a button, a price).

Everything you change is saved to a draft. Shoppers keep seeing the published store until you click Publish.

  1. Open Commerce → Stores (or Landing pages).
  2. Click Customize on the site.

You can also click Customize on any theme in the site’s Themes page to edit that theme without touching the live one.

The builder opens full screen. You need the commerce.manage permission to change anything. Without it, the builder is read-only and there is no Save or Publish button.

The builder has three areas:

  • Left panel: the page’s sections and the settings of whatever you select.
  • Middle: a live preview of your store.
  • Right: the AI assistant, when it’s open. See Fox in the builder.

On small screens, an Edit | Preview switch in the top bar flips between the panel and the preview.

Item What it does
Exit editor (back arrow) Back to Commerce. You’re asked first if something isn’t saved.
Sections The page’s sections and their settings.
Theme settings Store-wide look: logo, colors, fonts, buttons, cart, checkout and more. See Themes.
App embeds WhatsApp chat button and Repzo web chat. See Themes.
Code Edit your theme’s code files. A red dot means the code has errors. See Edit code.
Site / theme name Switch to another theme of the site, see its style and version, or open the Theme library.
Status badge Draft, Live, Hidden, or Password. See Store status.
EN / AR The language you’re editing, when the site has both.
Preview in market Show the preview in another market’s currency, when the store has more than one market.
Page switcher Pick the page to edit, or add one.
AI assistant Open or close Fox.
Inspector (pointer icon) On: click the preview to select sections. Off: click links and buttons to try the store.
Desktop preview / Mobile preview Switch the preview size.
Undo / Redo Step back or forward through your changes.
More (…) Edit default theme content, Translate store, Share preview, Store check, Version history, Keyboard shortcuts.
Save / Saved Save the draft now. The builder also saves by itself.
Publish Make the draft your live store.

Click the page name in the top bar to open the page switcher. Search for a page or pick a type:

Page type Store address Notes
Home page /
Products /products/<handle> A default template plus any named templates.
Collections /collections/<handle> A default template plus any named templates. /collections/all and /products show every product.
Collections list /collections Every collection.
Cart /cart
Search /search
Pages /pages/<address> Your own pages, such as About or Contact.
Content templates /pages/<type>/<entry> One template per content type. Every published entry gets its own page.
Blogs and Blog posts /blogs/<blog> and /blogs/<blog>/<post>
Gift card /gift_cards/<code link> The page a gift card’s private link opens.
Password What visitors see while the store is behind a password.
404 page Shown for an address that doesn’t exist.
Checkout, Thank you, Account, Sign in /checkout, /checkout/thank-you, /account Fixed layouts. See below.

Other languages add a prefix to the address, for example /ar/products/linen-shirt.

  1. Open the page switcher, go to Pages, and click Add page.
  2. Enter a Title. The Address fills in from it; change it if you like.
  3. Click Add page. It starts with a text section.

A site can have up to 50 pages.

Every product uses the Default product template unless you give it another one. To make a different layout, for example for gift items:

  1. Open the page switcher, go to Products (or Collections), and click Create template.
  2. Enter a Name and pick what it’s Based on.
  3. Click Create template.

Assign the template in the product’s Online store card (Theme template), or in the collection’s Theme template card. The page switcher shows how many products or collections use each template, such as Assigned to 3 products. See Products and collections.

Use the … menu on a template or page to Rename or Delete it. Deleting removes it from the draft. It leaves the live store when you publish.

A content template gives every entry of a content type (team members, recipes, store locations) its own page.

  1. Open the page switcher, go to Content templates, and click Create content template.
  2. Pick the Content type. Only types without a template are listed.
  3. Click Create template.

Content types without a template, and draft entries, have no page on the store.

Product, collection, blog post, and content template pages show one record at a time. Use Preview with at the top of the left panel to pick which product, collection, blog post, or entry the preview shows. This only changes the preview.

Click the settings icon next to the page title (Page settings and SEO) to change:

  • Page address (plain pages). Links to the old address stop working after you publish.
  • Search engine listing: Page title, Meta description, and a share image.
  • Hide from search engines: adds “noindex” and leaves the page out of the sitemap.

Product and collection pages use each record’s own SEO fields. The store-wide title format and default share image are in Theme settings → Search and sharing.

Checkout, Thank you, Account, and Sign in have a fixed layout. They have no store header or footer, and their sections can’t be added, removed, or moved. You can still change their blocks and settings, and style them in Theme settings → Checkout and accounts. How checkout works is covered in Checkout and payments.

The Sections view lists the page in three groups:

  • Header: the announcement bar and header, shared by every page.
  • Template: the sections of this page.
  • Footer: shared by every page.

Click a section to open its settings. Click the arrow next to it to see its blocks.

  1. Click Add section in a group, or click + between two sections in the preview.
  2. Search, or browse by category: Custom, Banners, Text, Storytelling, Products, Collections, Media, Forms, Layout, Store pages, Blog, Header, and Footer.
  3. Hover an option to see a live preview of it, then click it.

Many sections come in more than one look (presets), such as Hero or Collection list, and each preset is listed separately. Some sections only fit one kind of page. For example, Product reviews only goes on product pages, and Cart items only on the cart.

Sections you write in code show up first, under Custom. See Edit code.

Instead of picking from the list, you can describe what you want and let Fox build it with Generate. See Fox in the builder.

A group can hold up to 40 sections. Some sections, like the header, can appear only once on a page.

Select a section, then use the … menu at the top of its settings, or the toolbar that appears over it in the preview:

Action What it does
Ask AI to change it Ask Fox to change this section.
Copy Copy the section. Paste it on any page of any site with Paste section at the bottom of a group.
Duplicate Add a copy right below.
Rename Give it a name that only you see in the builder.
Hide / Show Keep it in the draft without showing it on the store.
Remove section Delete it.

To reorder sections, drag them by the handle in the list.

Blocks are the pieces inside a section. Click Add block under a section to add one.

Each section lists the blocks it accepts. Some sections (Hero, Rich text, Image with text, Product information, and Section) also accept universal blocks, grouped in the picker like this:

Group Blocks
Basic Heading, Text, Button, Image, Video, Icon, Accordion, Email signup
Decorative Divider, Spacer, Jumbo text, Marquee, Logo
Layout Group
Links Menu, Pop-up link
Product Product card, Title, Price, Buy buttons, Variant picker, Quantity, Stock status, SKU, vendor and tags, Star rating, Description, Special instructions
Collection Collection card, Collection title

The Section section is an empty container that you fill with any of these. It comes with presets such as Two columns, Featured product, and Banner with pop-up.

A Group block holds other blocks so you can lay them out together: side by side or stacked, aligned, with space between them, as a card, or with a background color.

A group can also pick a Product. Product blocks inside it (title, price, buy buttons…) then show that product. Without one, they show the page’s product.

Groups can go inside groups, up to 4 levels deep. A section can hold up to 150 blocks in total.

Drag a block to a new place in the list. Drop it on a group’s Add block row to put it first inside that group.

You can also use the block’s … menu: Move up, Move down, Move into the group above, or Move out of the group.

Selecting a section or block opens its settings below the page list. The fields come from the section itself: text, images, colors, product pickers, and so on.

Image fields let you Select image from your computer and add an image description for screen readers. They can also offer:

  • Explore free images: search free photos from Unsplash. The photo credit is shown under the field.
  • Generate image: describe a picture and AI makes it. See Fox in the builder.

Sections such as Hero have Show different media on mobile, so phones get their own Mobile image.

On pages that show a product, collection, blog post, or content entry, text, image, and link fields have a Connect dynamic source button. Use it to fill the field from the record on the page instead of typing it. For example, connect a heading to Product › Title.

Source Fields you can connect
Product Title, Description, Short description, Price, Price before discount, Vendor, SKU, Featured image, Link, and your product custom properties
Collection Title, Description, Image, Link
Blog post Title, Excerpt, Cover image, Link
Store Store name, Slogan, Short description, Logo, Cover image
Content entry The fields of the entry

A connected field shows as a chip, such as Product › Title. Click × to disconnect it.

At the bottom of every section’s settings, Section layout changes the section’s spacing and background without touching its own settings:

  • Spacing: Automatic keeps the section’s own spacing. Custom lets you set Space above, Space below, and Space between blocks in pixels.
  • Width: Page or Full (edge to edge).
  • Background: the Color scheme, a Color, or a Gradient, with an optional Text color.
  • Overlay: a see-through layer over the background and images, under the text. Pick its color, opacity, and style (Solid or Fade).

A Custom label shows when a section has its own layout. Reset to the section’s own layout removes it.

Custom CSS, at the bottom of a section’s settings, adds CSS that applies only to that section. Selectors are relative to the section. Rules that aren’t allowed are listed under the box and won’t be used. Each box holds up to 4,096 characters.

For CSS on every page, use Theme settings → Custom CSS.

The preview is your real store, drawn with your draft.

  • With the inspector on, click anything to select it. A toolbar appears with Ask AI, Duplicate, Hide, and Remove. Click + between sections to add one there.
  • With the inspector off, the preview works like the store, so you can open menus, add to cart, and follow links.
  • Mobile preview shows a phone-sized store.
  • Preview in market shows prices in another market’s currency, rounding, and tax display. Nothing is saved. See Markets.

The preview shows the WhatsApp button and a stand-in chat bubble, but never runs tracking pixels.

To show your unpublished store to someone else:

  1. Open More (…) → Share preview.
  2. Click Copy link and send it.

Anyone with the link can see the draft for 7 days. They can’t change anything. A bar at the top of the store says it’s a preview, with an Exit preview link back to the live store.

More (…) → Store check reviews the page on screen and the theme, and gives a score. Findings are grouped under Accessibility, Search, Speed, Content, and Publishing, each marked as something to fix, to improve, or a tip. Examples include images without a description, missing page titles, large images, links to pages that don’t exist, and [placeholders] left in the text.

Click Go to on a finding to jump to the section, setting, or code file it’s about.

Store check covers one page in the builder. The Store doctor on Commerce Home checks the whole live store every day.

When a site has English and Arabic, the EN / AR switch in the top bar picks which language you’re editing. Text fields keep a separate value per language, and the preview switches direction for Arabic.

To fill in the other language with AI, open More (…) → Translate store:

  1. Choose Only what’s missing or Everything (replaces translations you already have).
  2. Check the Estimated cost. It comes from your AI balance.
  3. Start the translation.

It translates sections, AI blocks, image descriptions, page titles, SEO, and the store’s built-in words. Brand and product names stay as they are. Undo puts the old text back.

To change the store’s built-in words yourself (“Add to cart”, “Sold out”…), use More (…) → Edit default theme content. See Themes.

The builder saves your draft a moment after each change. Save saves right away, and shows Saved when there’s nothing new.

Undo and Redo step through your last 100 changes. Typing in one field counts as one change.

If someone else changes the same theme at the same time (a teammate, Fox, or the CLI), the builder loads the latest version and tells you.

Click Publish to make the draft your live store. Every publish is kept as a numbered version. See Themes to restore one.

Publishing is refused while the theme’s code has errors. Click Show errors in the message to open the first one.

If you publish while the site’s Who can visit is still Draft, the store stays hidden. Click Open to everyone in the message to open it. See Sites.

The badge in the top bar shows where the theme stands:

Badge Meaning
Draft This theme isn’t published.
Live Published, and everyone can visit the store.
Hidden Published, but shoppers can’t visit yet because the site’s Who can visit is Draft.
Password Published, behind the store password.

Open More (…) → Keyboard shortcuts, or press ?. Shortcuts work in the builder and in the preview, except while you’re typing in a field. On Windows, use Ctrl instead of ⌘.

Shortcut Action
⌘ S Save
⌘ Z Undo
⌘ ⇧ Z Redo
⌘ ⇧ Enter Publish (asks first)
? Show keyboard shortcuts
M Switch the preview between desktop and mobile
F Open or close the AI assistant
[ / ] Select the previous / next section
Esc Deselect
A Add a section below the selection
⌘ D Duplicate the selection
⌘ C Copy the selected section
⌘ V Paste a copied section below the selection
Delete Remove the selection