The Store Builder
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.
Open the builder
Section titled “Open the builder”- Open Commerce → Stores (or Landing pages).
- 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 layout
Section titled “The builder layout”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.
The top bar
Section titled “The top bar”| 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.
Add a page
Section titled “Add a page”- Open the page switcher, go to Pages, and click Add page.
- Enter a Title. The Address fills in from it; change it if you like.
- Click Add page. It starts with a text section.
A site can have up to 50 pages.
Product and collection templates
Section titled “Product and collection templates”Every product uses the Default product template unless you give it another one. To make a different layout, for example for gift items:
- Open the page switcher, go to Products (or Collections), and click Create template.
- Enter a Name and pick what it’s Based on.
- 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.
Content templates
Section titled “Content templates”A content template gives every entry of a content type (team members, recipes, store locations) its own page.
- Open the page switcher, go to Content templates, and click Create content template.
- Pick the Content type. Only types without a template are listed.
- Click Create template.
Content types without a template, and draft entries, have no page on the store.
Preview with
Section titled “Preview with”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.
Page settings and SEO
Section titled “Page settings and SEO”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 and account pages
Section titled “Checkout and account pages”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.
Sections
Section titled “Sections”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.
Add a section
Section titled “Add a section”- Click Add section in a group, or click + between two sections in the preview.
- Search, or browse by category: Custom, Banners, Text, Storytelling, Products, Collections, Media, Forms, Layout, Store pages, Blog, Header, and Footer.
- 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.
Section actions
Section titled “Section actions”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
Section titled “Blocks”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.
Groups
Section titled “Groups”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.
Move blocks
Section titled “Move blocks”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.
Settings
Section titled “Settings”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.
Images
Section titled “Images”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.
Dynamic sources
Section titled “Dynamic sources”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.
Section layout
Section titled “Section layout”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
Section titled “Custom CSS”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
Section titled “The preview”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.
Share a preview
Section titled “Share a preview”To show your unpublished store to someone else:
- Open More (…) → Share preview.
- 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.
Store check
Section titled “Store check”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.
Languages
Section titled “Languages”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:
- Choose Only what’s missing or Everything (replaces translations you already have).
- Check the Estimated cost. It comes from your AI balance.
- 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.
Saving, undo, and publishing
Section titled “Saving, undo, and publishing”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.
Publish
Section titled “Publish”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.
Store status
Section titled “Store status”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. |
Keyboard shortcuts
Section titled “Keyboard shortcuts”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 |