# The Store Builder

> Design your online store's pages with sections and blocks, preview them on desktop and mobile, check them, and publish when you're ready.

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

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](https://workstation.repzo.com/docs/online-store/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

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](https://workstation.repzo.com/docs/online-store/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

| 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](https://workstation.repzo.com/docs/online-store/themes#theme-settings). |
| **App embeds** | WhatsApp chat button and Repzo web chat. See [Themes](https://workstation.repzo.com/docs/online-store/themes#app-embeds). |
| **Code** | Edit your theme's code files. A red dot means the code has errors. See [Edit code](https://workstation.repzo.com/docs/online-store/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](#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](https://workstation.repzo.com/docs/online-store/markets). |
| 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. |

## Pages

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](#checkout-and-account-pages). |

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

### Add a page

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.

### 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:

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](https://workstation.repzo.com/docs/online-store/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

A content template gives every entry of a [content type](https://workstation.repzo.com/docs/online-store/navigation-and-content) (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.

### 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

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

**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](https://workstation.repzo.com/docs/online-store/checkout-and-payments).

## 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

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](https://workstation.repzo.com/docs/online-store/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](https://workstation.repzo.com/docs/online-store/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

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

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

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

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

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

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](https://workstation.repzo.com/docs/online-store/fox-in-the-builder).

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

### 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](https://workstation.repzo.com/docs/administration/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

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

**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

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](https://workstation.repzo.com/docs/online-store/markets).

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

### Share a preview

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.

## 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](https://workstation.repzo.com/docs/online-store) on Commerce Home checks the whole live store every day.

## 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**:

1. Choose **Only what's missing** or **Everything** (replaces translations you already have).
2. Check the **Estimated cost**. It comes from your [AI balance](https://workstation.repzo.com/docs/commerce/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](https://workstation.repzo.com/docs/online-store/themes#default-theme-content).

## 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

Click **Publish** to make the draft your live store. Every publish is kept as a numbered version. See [Themes](https://workstation.repzo.com/docs/online-store/themes#version-history) 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](https://workstation.repzo.com/docs/online-store/sites).

### 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

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 |

## Related pages

- [Themes](https://workstation.repzo.com/docs/online-store/themes)
- [Fox in the builder](https://workstation.repzo.com/docs/online-store/fox-in-the-builder)
- [Edit code](https://workstation.repzo.com/docs/online-store/edit-code)
- [Sites](https://workstation.repzo.com/docs/online-store/sites)
- [Products and collections](https://workstation.repzo.com/docs/online-store/products-and-collections)
- [Navigation and content](https://workstation.repzo.com/docs/online-store/navigation-and-content)
- [Markets](https://workstation.repzo.com/docs/online-store/markets)
