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

# Import the demo content

> Download the Gloaming demo kit and set up a store like the demo in about 15 minutes.

A fresh install of Gloaming shows drawn placeholders instead of sample jewelry, so your own pieces show from day one. To start from the full demo instead, for practice, a client preview or a faster launch, download the **Gloaming demo kit** and import it into a new or development store.

> [card] [Download the Gloaming demo kit](https://drive.google.com/file/d/1vcxCFX-dxksRdO-5WqIoKQy6xXRaYjY1/view?usp=sharing)
>
> Version 0.1.0, a ZIP of about 84 MB: the pre-configured theme, the demo catalog, the importer, a product CSV, and every photograph and film the demo uses.

> [!TIP]
>
> The kit is on Google Drive. Click **Download** at the top right of the Drive page. If Drive says it can't scan the file for viruses, click **Download anyway**.

> [!NOTE]
>
> A Shopify theme can't create products, pages or menus, so it can't import its own demo content. The kit's **importer** does it instead: a small script you run once on your computer, which adds everything to your store through Shopify's own command line tool.

## What is in the demo kit

| Folder | What it is |
| - | - |
| `theme/gloaming-demo-theme-0.1.0.zip` | Gloaming with every section filled in: the hero film, the arched collections, the vertical films, shop the look, the journal, boutiques and events, the spin wheel with four real codes, and the logo text. |
| `setup/` | The importer (`setup.mjs`) and its `package.json`. |
| `data/catalogue.json` | What the importer creates: 24 pieces of jewelry (plus a gift card you create yourself), 10 collections, 8 pages, the Journal and Events blogs with 16 posts, the menus, and the 85 photographs and 10 films the sections use. |
| `media/` | Copies of the 85 photographs, 10 film posters and 10 films the demo uses, under the file names the theme looks for. `media.json` lists each file's source and author. |
| `products/gloaming-demo-products.csv` | The products in Shopify's import format, for setting up by hand. |
| `CREDITS.md` | Where every photograph (Unsplash) and film (Pexels) comes from. |
| `README.md` | The full setup guide. |

The importer uploads the films from `media/films`. Shopify fetches the photographs from Unsplash itself; if one of those links ever stops working, upload its copy from `media/photos` under **Content → Files**, keeping the file name.

## Import with the importer (about 15 minutes)

**1. Unzip the kit**

Unzip the kit anywhere on your computer. Keep the `media` folder next to `setup`.

**2. Run the importer**

You need [Node.js](https://nodejs.org) 22 or newer. In a terminal, open the kit's `setup` folder and run:

```bash theme={null}
npm install
node setup.mjs your-store.myshopify.com auth
node setup.mjs your-store.myshopify.com
```

The first command installs Shopify's command line tool for this folder. The second opens your browser once to approve the access the importer needs. The third creates the metafield definitions, the metal swatches, a boutique location with local pickup, the products with their photographs and stock, the collections, pages, blogs and posts, the menus, the four spin wheel discount codes, and the section photographs and films in **Content → Files**. It is safe to run again: anything that already exists is reused. A log goes to `setup/logs/`.

**3. Upload the demo theme**

In the Shopify admin go to **Online Store → Themes**, then under Draft themes click **Import → Upload zip file** and choose `theme/gloaming-demo-theme-0.1.0.zip`. Click **Preview** to check it, then **Publish** when you are ready. Development stores show a password page first; the password is under **Online Store → Preferences**.

![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

> [!WARNING]
>
> The importer replaces the items in your store's **main menu** and **footer menu**, adds a store location and creates four discount codes. Run it on a new or development store, not on a live shop.

Run the importer before uploading the theme: the theme finds its photographs and films by file name. If the theme went up first and some media are missing, upload the theme ZIP again.

## What the kit does not do

* **Gift card product:** Shopify only creates gift cards once gift cards are activated in your store's settings. Create a product called Gift card, choose Gift card as the product type, and add the denominations you want.
* **Quantity price breaks:** these need a B2B catalog.
* **Pre-order deposits:** these need a selling plan app.
* **Complete the set:** complementary products are added in the Search & Discovery app.
* **Filters:** add them in Search & Discovery; see [Filters with Search & Discovery](https://docs.kwebby.com/gloaming/guides/search-and-discovery-filters.md).

## Import by hand

No command line? Create the product metafield definitions in **Settings → Custom data** (namespace `custom`, the keys in the CSV column headers, storefront access on), then import `products/gloaming-demo-products.csv` in **Products → Import**, and upload the files in `media/` under **Content → Files**, keeping their names. Collections, pages, blogs and menus are much quicker with the importer; their full list is in `data/catalogue.json`.

## Good to know

* **Spin wheel:** the demo wheel offers four codes the importer creates: NUIT10 (10% off), SALON5 (5% off), PERLE15 (15% off the Perle collection) and SALON250 (\$250 off orders of \$2,500 or more). Each is limited to one use per customer. Change the prizes or turn the wheel off under **Overlays → Spin wheel**.
* **Countdowns:** the demo sale countdown follows a sample end date. Change it or clear it in **Home page → Sale countdown**; it hides itself when the time runs out.

![The demo spin wheel in the theme editor](https://mintcdn.com/kwebby/ipMVAv6ECVUC3DoM/images/vesper/editor-spin-wheel.webp?fit=max\&auto=format\&n=ipMVAv6ECVUC3DoM\&q=85\&s=4e49a75bddcdffd33712cf567e03f094)

The demo wheel in the theme editor: 1 Spin wheel, under Overlays · 2 its settings; each prize is a block

> [!WARNING]
>
> The demo photographs come from Unsplash and the films from Pexels (sources in `CREDITS.md`). They are for demo and preview stores only. Replace them with photographs and films of your own pieces before you sell.


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