> ## 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 Puggy demo kit and set up a store like the demo in about 10 minutes.

A fresh install of Puggy shows its built-in pet artwork and placeholders, so your own products show from day one. To start from the full demo instead, for practice, a client preview or a faster launch, download the **Puggy demo kit** and import it into a new or development store.

> [card] [Download the Puggy demo kit](https://drive.google.com/file/d/1vMiTd_rquAuS-LwuiE9HwC85V07rWaHe/view?usp=sharing)
>
> Version 1.0.0, a ZIP of about 4 MB: the pre-configured theme, 9 sample products with photos, pages, a journal post, menus and the importer.

> [!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/puggy-demo-theme.zip` | Puggy with every section filled in: the Shop mega menu, footer menus, category cards, favorites, the dog and cat collections, the Our story timeline, the PUGGY10 offer popup and the logo text. |
| `products/puggy-demo-products.csv` | 9 products in Shopify's import format, one per category, tagged Dogs, Cats or Small pets, two of them on sale. |
| `media/` | 12 images: 11 product photos and the journal post's photo, original artwork made for Puggy. |
| `setup/` | The importer. |
| `README.md` | The full setup guide, including every step by hand. |

## Import with the importer (about 10 minutes)

**1. Unzip the kit**

Unzip the kit anywhere on your computer.

**2. Run the importer**

You need [Node.js](https://nodejs.org) 22 or newer and a store you own; a new development store is ideal. In a terminal, open the kit's `setup` folder and run:

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

Your browser opens once and asks you to approve access to your store. The importer then creates two custom data definitions, the products with their photos, 12 collections, 5 pages, the Journal blog and its post, the main menu, three footer menus and the PUGGY10 discount. It is safe to run again: anything that already exists is reused.

To see every change first, add `--dry-run`. It lists each step and changes nothing.

**3. Upload the demo theme**

In the Shopify admin go to **Online Store → Themes**. Under Draft themes, click **Import → Upload zip file** and choose `theme/puggy-demo-theme.zip`.

**4. Preview, then publish**

Click **Preview**, or **Publish** when you are ready. Development stores show a password page first; the password is under **Online Store → Preferences**.

Run the importer before you upload the theme. If the theme went up first and a menu, collection or page is missing from it, upload the theme ZIP again.

> [!WARNING]
>
> The importer replaces the items in your store's **main menu** with the demo menu; the three footer menus are new menus. Run it on a new or development store, not on a live shop with a menu you want to keep.

## Import by hand (about 30 minutes)

No command line? Do these in order in the Shopify admin.

1. **Custom data** (Settings → Custom data). Optional, these only add extra labels. Create them with namespace `custom` and storefront access on:

   | Owner | Name | Key | Type |
   | - | - | - | - |
   | Products | Badge | `badge` | Single line text |
   | Variants | Pet size label | `pet_size` | Single line text |

2. **Products** (Products → Import). Choose `products/puggy-demo-products.csv`. Shopify downloads the photos while it imports.

3. **Collections** (Products → Collections → Create collection, Smart, all conditions):

   | Title | URL handle | Conditions |
   | - | - | - |
   | Dogs | `dogs` | Tag is equal to `Dogs` |
   | Cats | `cats` | Tag is equal to `Cats` |
   | Food | `food` | Type is equal to `Food` |
   | Treats | `treats` | Type is equal to `Treats` |
   | Toys | `toys` | Type is equal to `Toys` |
   | Walk & travel | `walk-travel` | Type is equal to `Walk & travel` |
   | Beds & blankets | `beds-blankets` | Type is equal to `Beds & blankets` |
   | Grooming | `grooming` | Type is equal to `Grooming` |
   | Litter & cleanup | `litter-cleanup` | Type is equal to `Litter & cleanup` |
   | Bowls & feeders | `bowls-feeders` | Type is equal to `Bowls & feeders` |
   | Small pets | `small-pets` | Type is equal to `Small pets` |
   | Puggy favorites | `puggy-favorites` | Tag is equal to `favorites` |

4. **Pages** (Online Store → Pages). Set each URL handle under Edit website SEO and pick the template:

   | Title | URL handle | Template |
   | - | - | - |
   | Our story | `about` | about |
   | Curious paws welcome. | `faq` | faq |
   | The journey to happy paws. | `shipping` | Default page |
   | A little help with returns. | `returns` | Default page |
   | Contact | `contact` | contact (edit the existing Contact page if there is one) |

5. **Journal** (Online Store → Blog posts). Under Manage blogs, add a blog called Journal with the URL handle `journal`, then a post titled Small rituals. Very happy paws. with the URL handle `happy-paws-guide` and `media/puggy-happy-pet-routine.webp` as its featured image.

6. **Menus** (Online Store → Navigation). Build the Main menu (`main-menu`) and the footer menus Find their favorites (`find-their-favorites`), A little help (`a-little-help`) and Get to know Puggy (`get-to-know-puggy`); the kit's README lists every link. Each menu's handle has to match.

7. **Discount** (Discounts → Create discount → Amount off order). Code `PUGGY10`, 10%, all customers, one use per customer, no minimum, no end date. This is the code the offer popup shows.

8. **Theme.** Upload `theme/puggy-demo-theme.zip` as in the importer steps above.

## Good to know

* **Offer popup:** the mascot opens a 10% offer with code PUGGY10, and the popup also opens on its own after 30 seconds. Change or turn it off in the theme editor under Promotions and privacy → Promotion. If you delete the discount, turn the popup off too.
* **Sale badges:** Good Dog Biscuits and Table for Two Bowls have a compare-at price, which shows the sale badge and the struck-through price.
* **Pet size cards:** products tagged `Dogs` or `Cats` with two to five sizes show them as cards with a dog or cat silhouette. See [Pet size labels](https://docs.kwebby.com/puggy/guides/pet-size-labels.md).
* **Favorites:** the home page favorites row shows the Puggy favorites collection. Tag any product `favorites` to add it.
* **Photos missing on a product?** The importer adds photos only when it creates a product. If a product with the same URL handle was already there, delete it and run the importer again.
* **Privacy and Terms:** the footer links open your store's own policies. Fill them in under **Settings → Policies**. The Shipping and Returns pages are sample text; replace them before you launch.

> [!NOTE]
>
> All images in the kit are original artwork made for Puggy. You may use them in your store while you use Puggy, including commercially, but not sell the files themselves.


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