---
title: Themes
description: Add RetailPrime's starter theme, preview it, publish it, and rename, duplicate, download, upload and delete themes.
---

A **theme** decides how your store looks to buyers: its colours, fonts, the home page, and the product, collection and other pages. Your store shows one theme at a time, the **current theme**. You can keep other themes in a **theme library** and publish one of them instead whenever you like.

A new store has no theme, so buyers can't see anything yet. This page adds RetailPrime's **starter theme** and publishes it. The next pages show how to change it in the **theme editor**.

## Open Themes

In the sidebar, under **Sales channels**, press **Online Store**. The **Themes** page opens: **The theme your store shows, and the themes you can publish instead.**

A new store says **No theme is published yet. Add a theme, then publish it.** under **Current theme**, and **No other themes** in the **Theme library**.

![The Themes page of a new store: Current theme with No theme is published yet. Add a theme, then publish it., and an empty Theme library with No other themes](/screenshots/online-store/01-themes-empty.jpg)

## Add the starter theme

1. Press **Add theme** at the top right. The **Add theme** window opens. It says **Add RetailPrime's starter theme, or upload a theme as a zip file of up to 50 MB. Either is checked, then added to your library unpublished.**

   ![The Add theme window: Starter theme with A simple, accessible theme with a home page, product and collection pages, and search. and Add starter theme, then Upload a zip file with Choose zip file, Cancel and Upload theme](/screenshots/online-store/02-add-theme.jpg)

2. Under **Starter theme**, press **Add starter theme**.
3. The window closes and the page says **Starter is being processed. It appears in the library when it is ready.** After a few seconds, **Starter** shows in the **Theme library** with the status **Ready**.

![The Theme library with the Starter theme, Ready, and its buttons Customize, Preview, Publish, Rename, Duplicate, Download and Delete](/screenshots/online-store/03-starter-ready.jpg)

Each theme in the library has these buttons:

| Button | What it does |
| --- | --- |
| **Customize** | Opens the theme in the theme editor (see [The theme editor](/online-store/the-theme-editor)) |
| **Preview** | Opens your store with this theme in a new tab, without publishing it |
| **Publish** | Makes this the theme your store shows |
| **Rename** | Changes the theme's name |
| **Duplicate** | Makes a copy of the theme in the library |
| **Download** | Saves the theme to your computer as a zip file |
| **Delete** | Deletes the theme from the library |

## Preview a theme

Press **Preview** next to **Starter**. Your store opens in a new browser tab with the theme. A black bar at the top says **Previewing Starter**, so you know buyers don't see this yet.

![The store in preview: a black bar with Previewing Starter and Exit preview, the Sunny Socks header with Catalog and Collections, and the Welcome to our store banner with Shop all](/screenshots/online-store/04-preview-tab.jpg)

Press **Exit preview** in the black bar when you are done. The bar goes away and the tab shows your store as buyers see it.

![The same tab after Exit preview: the store without the black bar](/screenshots/online-store/04b-preview-exited.jpg)

## Publish a theme

1. Back in the Admin, press **Publish** next to **Starter**.
2. A window asks **Publish Starter?** and says **Your store will show this theme.**

   ![The Publish Starter? window with Your store will show this theme., Cancel and Publish](/screenshots/online-store/05-publish-dialog.jpg)

3. Press **Publish**. The page says **Starter is published.** The theme moves up to **Current theme**, with when it was last **Saved** and how many files it has.

![The Themes page with Starter is published., Starter as the Current theme, Saved with the date and 45 files, and the View store, Customize, Rename, Duplicate and Download buttons](/screenshots/online-store/06-starter-published.jpg)

The current theme has no **Publish**, **Preview** or **Delete** buttons. Instead it has **View store**, which opens your store in a new tab.

:::note[Your store's password]
Until you choose a plan, your store asks visitors for its password (see [Create your store](/getting-started/create-your-store)). From here on, the pictures of the store are of a store whose plan is chosen, so buyers see it without a password. [Preferences](/online-store/preferences-and-the-password-page) shows the password page.
:::

![The store after View store: the Sunny Socks header and the Welcome to our store banner](/screenshots/online-store/08-view-store.jpg)

## Rename a theme

1. Press **Rename** next to the theme.
2. In the **Rename theme** window, type the new name in **Theme name** (up to 50 characters), such as `Sunny Socks`.

   ![The Rename theme window with Sunny Socks typed in Theme name, Cancel and Save](/screenshots/online-store/09-rename-theme.jpg)

3. Press **Save**. The page says **Theme renamed.**

## Duplicate a theme

Press **Duplicate**. The page says **Sunny Socks was duplicated.**, and **Copy of Sunny Socks** appears in the library. A copy is a safe place to try changes: buyers keep seeing the current theme until you publish the copy.

![The Themes page with Sunny Socks was duplicated., Sunny Socks as the Current theme, and Copy of Sunny Socks, Ready, in the Theme library](/screenshots/online-store/10-theme-duplicated.jpg)

When you press **Customize** on a theme in the library, the theme editor's button at the top right says **Save to theme** instead of **Publish**: your changes are saved into that theme, and buyers don't see them until you publish it. Press **← Themes** at the top left to come back.

![The theme editor for Copy of Sunny Socks, with Save to theme at the top right instead of Publish](/screenshots/online-store/11-editor-library-theme.jpg)

## Download a theme

Press **Download**. Your browser saves the theme as a zip file named after it, such as `Sunny-Socks.zip`. Keep it as a backup, or give it to a developer to change.

## Upload a theme

To add a theme you have as a zip file (for example one you downloaded, or one a developer made):

1. Press **Add theme**.
2. Under **Upload a zip file**, press **Choose zip file** and pick the file. Its name and size show under the button.

   ![The Add theme window with winter-socks.zip (and its size) chosen under Upload a zip file](/screenshots/online-store/12-upload-zip.jpg)

3. Press **Upload theme**. The page says **winter-socks is being processed. It appears in the library when it is ready.** The theme is named after the zip file. While it is checked, its status is **Processing**, and only **Rename** and **Delete** are offered.

   ![The Theme library with winter-socks, Processing, with Rename and Delete only](/screenshots/online-store/13-upload-processing.jpg)

4. After a few seconds the status turns to **Ready**.

A file bigger than 50 MB is refused with **This file is larger than 50 MB.**

### A theme with mistakes

If the theme's files have a mistake, its status turns to **Failed** and it has a **View errors** button instead of **Customize**, **Preview** and **Publish**.

![The Theme library with broken-socks, Failed, with Rename, View errors and Delete](/screenshots/online-store/14-upload-failed.jpg)

Press **View errors**. The **Errors in broken-socks** window lists each mistake with the file and line, and says **Fix these in the theme files and upload the theme again.** Press **Close**.

![The Errors in broken-socks window: snippets/badge.ctl, line 1: Unknown filter "shout".](/screenshots/online-store/15-theme-errors.jpg)

A theme that works but has something worth a look has **View warnings** instead, with the window saying **The theme works; these may be worth a look.**

## Publish a different theme

Press **Publish** next to a theme in the library. The window says **Your store will show this theme instead of Sunny Socks, which moves to the library.** Press **Publish** to switch, or **Cancel** to keep the current theme.

![The Publish winter-socks? window: Your store will show this theme instead of Sunny Socks, which moves to the library.](/screenshots/online-store/16-publish-instead.jpg)

## Delete a theme

1. Press **Delete** next to a theme in the library. The current theme can't be deleted: publish another one first.
2. A window asks **Delete broken-socks?** and says **The theme and its files are deleted. This cannot be undone.**

   ![The Delete broken-socks? window with Keep and Delete](/screenshots/online-store/17-delete-theme.jpg)

3. Press **Delete**. The page says **broken-socks was deleted.** Press **Keep** instead to change your mind.

![The Themes page with broken-socks was deleted., and winter-socks and Copy of Sunny Socks left in the library](/screenshots/online-store/18-theme-deleted.jpg)

## What's next

[The theme editor](/online-store/the-theme-editor): change the words, pictures and colours of your theme.
