# Themes

> Manage your site's themes, change the store-wide look in Theme settings, add app embeds, and publish, schedule, or roll back a theme.

A **theme** is the complete design of a site: its pages, sections, theme settings, and any code files. A site has one live theme that shoppers see, and a **theme library** where you can try new looks without touching the live store.

Your products, collections, menus, and orders don't belong to a theme. Switching themes changes how the store looks, not what it sells.

## The Themes page

Open **Commerce → Stores** (or **Landing pages**) and click **Themes** on the site.

The top of the page shows the **live theme** with a preview, its style, when it was last saved, and when it was published. Click **Customize** to edit it in the [store builder](https://workstation.repzo.com/docs/online-store/store-builder). It shows **Not published yet** until the site's first publish.

Below it, the **Theme library** lists your other themes. Each row shows the theme's style and when it was saved and last published, with **Publish** and **Customize** buttons.

A site can keep up to 20 themes. You need `commerce.manage` to add, change, publish, or delete themes.

### Add a theme

Click **Add theme** and pick where it starts:

| Option | What you get |
|---|---|
| **From the template gallery** | A complete design with its own pages, pictures, and custom sections. See [Sites](https://workstation.repzo.com/docs/online-store/sites) for the templates. |
| **From a theme style** | A style's colors, fonts, and a home page that suits it. |
| **Duplicate the current theme** | A copy of the live theme to experiment on. |
| **Import a theme file** | A `.json` theme file you downloaded earlier, from this or another workspace. |

The new theme lands in the theme library. The live store doesn't change until you publish it.

When you import a theme file from another workspace, its images keep their web addresses but aren't linked to your media library.

### Theme actions

Use the **…** menu on a theme:

- **Rename**: only you and your team see theme names.
- **Duplicate**: make a copy.
- **Schedule publish** (library themes): pick a time for the theme to go live. See [Schedule a publish](#schedule-a-publish).
- **Download theme file**: save the theme as a `.json` file, for a backup or to import elsewhere.
- **Delete** (library themes): remove the theme and its pages. The live theme can't be deleted; publish another theme first.

## Publish a theme

In the theme library, click **Publish** on a theme. It replaces the current theme as your site's theme, and the old one stays in your library.

You can also publish from the builder with **Publish**. Every publish creates a new version, so you can roll back later.

Publishing is refused while the theme's [code](https://workstation.repzo.com/docs/online-store/edit-code) has errors.

### Schedule a publish

To switch themes at a set time, for example at the start of a sale:

1. Open the theme's **…** menu in the library and click **Schedule publish**.
2. Pick the **Date** and **Time**. Times use your own time zone, at least a minute from now and within the next year.
3. Click **Schedule**.

Keep editing the theme until then. Its latest saved version goes live at that moment. A banner at the top of the Themes page shows what's scheduled and who scheduled it, with **Change** and **Cancel schedule**.

A site keeps one schedule. Scheduling another theme replaces it. If the theme has code errors when its time comes, it isn't published and the schedule is dropped. Workspaces that are read-only for billing reasons don't publish until they're active again.

### Version history

Open **More (…) → Version history** in the builder. It lists every publish as **Version 1**, **Version 2**, and so on, with the date and theme name, and marks the **Live** one.

Click **Restore** to put a version back in the editor. The live store doesn't change until you publish it again.

### Store status

The badge next to the theme name in the builder shows **Draft**, **Live**, **Hidden**, or **Password**. See [Store status](https://workstation.repzo.com/docs/online-store/store-builder#store-status).

## Theme styles

A theme style is a ready-made look: color schemes, fonts (Latin and Arabic), sizes, widths, corners, and product cards. The styles are Minimal, Bold, Luxury, Playful, Modest fashion, Beauty, Food & café, Electronics, Boutique, Market, and Studio.

To restyle a theme you're already working on, open **Theme settings** in the builder and scroll to **Change theme style**. Pick a style and confirm. It replaces the theme's color schemes, fonts, sizes, and corners. Your pages, sections, and logo stay, and you can undo it.

The builder's theme menu (click the theme name in the top bar) shows the theme's **Style**, **Kit version**, when it was **Published**, and when it **Goes live** if it's scheduled. It also lets you switch to another theme or open the **Theme library**.

## Theme settings

Click **Theme settings** in the builder's top bar for the settings that apply to every page:

| Group | What it controls |
|---|---|
| **Logo and favicon** | Your logo, its width, and the browser tab icon. |
| **Colors** | The theme's [color schemes](#color-schemes). |
| **Typography** | Heading, body, and Arabic fonts, and their sizes. |
| **Layout** | Page width and the space between sections. |
| **Buttons** | Corner radius and the secondary button style. |
| **Variant pills** | How size and color options look on product pages. |
| **Inputs** | Corners and borders of text fields. |
| **Product cards** | Image ratio and fit, corners, card style, and whether to show the vendor. |
| **Collection cards** | How collection titles show on cards. |
| **Blog cards** | Card style and image ratio for blog posts. |
| **Badges** | Sale and sold-out badges: on or off, text, position, shape, and colors. |
| **Media** | Borders and shadows on images and videos. |
| **Pop-ups and drawers** | Corners and shadows of pop-ups and the cart drawer. |
| **Icons** | Icon line thickness and color. |
| **Brand information** | Slogan, short description, and cover image. Sections can show them through [dynamic sources](https://workstation.repzo.com/docs/online-store/store-builder#dynamic-sources). |
| **Social media** | Links to Instagram, TikTok, Snapchat, X, Facebook, YouTube, LinkedIn, Pinterest, and WhatsApp. |
| **Search behavior** | Search suggestions, and whether they show the vendor and price. |
| **Currency format** | Whether prices show currency codes. |
| **Cart** | Cart type (drawer, page, or pop-up), vendor, cart note, and a collection to show in an empty cart. |
| **Checkout and accounts** | The look of the checkout, thank-you, account, and sign-in pages: logo, colors, background image, font, corners, pay button, and fields. |
| **Search and sharing** | The page title format and the default share image. |
| **Custom CSS** | CSS for every page of the store. `body` and `:root` mean the whole store. |

**Change theme style** is at the bottom of the list.

### Color schemes

Sections and blocks don't pick colors one by one. They pick a **color scheme**, and the theme defines what each scheme looks like. A scheme has five colors: **Background**, **Text**, **Accent**, **Button**, and **Button text**.

A theme starts with three schemes and can have up to 8. In **Theme settings → Colors**, click a scheme to change its name or colors, or click **Add scheme**. **Scheme 1** is the main scheme. Sections whose scheme is deleted use it.

[Store check](https://workstation.repzo.com/docs/online-store/store-builder#store-check) warns when a scheme's text or button label is hard to read on its background.

## Default theme content

The store's built-in words, such as "View all", "Add to cart", and "Sold out", come with the theme. To change them, open **More (…) → Edit default theme content** in the builder.

The words are grouped under General, Products, Cart, Forms, Checkout and accounts, and Accessibility, with a search box. Each word has a field for every language the site has. Leave a field empty to use the default.

**Translate store** also fills in these words. See [Languages](https://workstation.repzo.com/docs/online-store/store-builder#languages).

## App embeds

Click **App embeds** in the builder's top bar to add things that sit on every page:

| App embed | What it does |
|---|---|
| **WhatsApp chat button** | A floating button that opens a WhatsApp chat with your number. Set the **WhatsApp number**, a starting **Message**, and the **Position** (mirrored on the Arabic store). |
| **Repzo web chat** | Your website chat widget, answered from [Inbox](https://workstation.repzo.com/docs/operations/inbox). Pick the **Chat widget** you set up in Inbox. |

The chat widget loads on your live store only. The preview shows the WhatsApp button and a stand-in chat bubble.

Meta, Google, TikTok, and Snap pixels are set per store in **Commerce → Settings → Pixels**, so they keep working when you change themes. See [Analytics](https://workstation.repzo.com/docs/online-store/analytics). The older pixel embeds still show in this list for themes that were set up with them.

To put an AI agent on the store chat, see [AI shopping](https://workstation.repzo.com/docs/online-store/ai-shopping).

## Related pages

- [The store builder](https://workstation.repzo.com/docs/online-store/store-builder)
- [Sites](https://workstation.repzo.com/docs/online-store/sites)
- [Edit code](https://workstation.repzo.com/docs/online-store/edit-code)
- [Fox in the builder](https://workstation.repzo.com/docs/online-store/fox-in-the-builder)
- [Analytics](https://workstation.repzo.com/docs/online-store/analytics)
- [AI shopping](https://workstation.repzo.com/docs/online-store/ai-shopping)
