> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kwebby.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the theme

> Add Gloaming to your store, preview it, and publish when you are ready.

You can add Gloaming to your store without changing what your customers see. A new theme arrives **unpublished**: you can edit and preview it while your current theme stays live.

## Upload the theme file

**1. Open your themes**

In your Shopify admin, go to **Online Store → Themes**.

![The Themes page in the Shopify admin](https://mintcdn.com/kwebby/ipMVAv6ECVUC3DoM/images/vesper/admin-themes.webp?fit=max\&auto=format\&n=ipMVAv6ECVUC3DoM\&q=85\&s=77dcec9906f042efeddc6586640835e8)

Online Store → Themes: 1 Import, under Draft themes · 2 your current theme

**2. Upload the ZIP file**

Under **Draft themes**, click **Import → Upload zip file**, choose the `Gloaming` ZIP file you received, and click **Upload file**. Do not unzip it first.

![The Upload zip file option](https://mintcdn.com/kwebby/ipMVAv6ECVUC3DoM/images/vesper/admin-upload.webp?fit=max\&auto=format\&n=ipMVAv6ECVUC3DoM\&q=85\&s=e78ee392990488474a89de52c64266d6)

1 Import · 2 Upload zip file

**3. Wait for it to finish**

Gloaming appears in your theme library with an **Unpublished** label when the upload is done. It usually takes under a minute.

**4. Preview and customize**

Click **Customize** to open the theme editor, or **⋯ → Preview** to see it as a customer would. Nothing changes on your live store until you publish.

**5. Publish when you are ready**

Click **⋯ → Publish** in the theme library. Your previous theme stays in the library, so you can switch back at any time.

> [!TIP]
>
> Before publishing, preview on your phone as well as your computer, add a piece to the bag, and check a product with metal and ring size options.

## Set up in this order

1. [Set up your products](https://docs.kwebby.com/gloaming/getting-started/set-up-products.md): options, metafields and swatches.
2. Create your [pages and templates](https://docs.kwebby.com/gloaming/guides/pages-and-templates.md) and [menus](https://docs.kwebby.com/gloaming/guides/menus-and-mega-menu.md).
3. Add [filters](https://docs.kwebby.com/gloaming/guides/search-and-discovery-filters.md) with Search & Discovery.
4. Fill in the home page sections, from the [Hero film](https://docs.kwebby.com/gloaming/sections/hero-film.md) down.
5. Turn on any promotions you want, such as the [spin wheel](https://docs.kwebby.com/gloaming/guides/spin-wheel.md).

## Want the demo store look?

A fresh install starts with placeholders, so your own pieces show from the start. To start from the full demo instead, follow [Import the demo content](https://docs.kwebby.com/gloaming/getting-started/demo-content.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.