> For the complete documentation index, see [llms.txt](https://docs.webexp.dev/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.webexp.dev/supra-shopify-theme/supra/getting-started/installation.md).

# Installation

How to upload SUPRA to your Shopify store.

## What you have after purchase

Your purchase email links to a downloadable folder. Inside it:

* `SUPRA Theme (vX.Y).zip` — the actual theme file
* `SUPRA — Setup Guide.pdf` — printable setup walkthrough

You only upload the **theme zip** to Shopify. The PDF is for reference.

## Upload the theme

1. Open your Shopify admin
2. **Online Store** → **Themes**
3. Top-right dropdown → **Add theme** → **Upload zip file**
4. Select `SUPRA Theme (vX.Y).zip`
5. Wait for it to process (usually 30 seconds)

Once uploaded, SUPRA shows up in your **Theme library** — but it's not live yet.

## Customize before publishing

Don't publish yet. Click **Customize** on the SUPRA theme first and check it against your own products. The theme editor opens and nothing you do there is visible to customers until you hit **Publish**.

## Common issues

**"Theme upload failed"** Make sure you uploaded the **inner** zip, not the outer download folder. The download is wrapped in a folder containing the PDF and the actual theme zip — Shopify only takes the theme zip.

**"This theme is incompatible with your Shopify plan"** SUPRA requires a Basic Shopify plan or higher. Trial plans work for upload and customization but not for going live.

**"Section settings reset" or weird previews** Hard refresh the theme editor (`Cmd + Shift + R` on Mac, `Ctrl + Shift + R` on Windows). Shopify caches theme assets aggressively.

## What's next

Head to [First-Time Setup](/supra-shopify-theme/supra/getting-started/first-time-setup.md).