Getting started with Valor Theme.

Installation

1. Download Valor Theme

   Fill in the download form on the homepage with your email and Shopify store domain, agree to the license terms, and submit. You'll receive a download link by email, and the download will also be available on the confirmation page that appears immediately.

2. Open Shopify admin

   Log in to your Shopify admin and navigate to Online Store → Themes from the left sidebar.

3. Add the theme

   Scroll to the Theme library section. Click Add theme and select Upload zip file from the dropdown.

4. Upload Valor Theme ZIP

   Click Choose File, select the latest Valor ZIP you downloaded, for example valor-v1.4.7.zip, then click Upload. The theme will appear in your library within a few seconds.

5. Customize the theme

   Click Customize on the Valor Theme card. The Shopify Theme Editor opens. Set your typography, colors, and section content. Your changes save automatically as you work.

6. Preview your store

   Use the device toolbar at the top of the editor to preview on desktop, tablet, and mobile. Click the Preview button (top right) to open a full preview in a new tab — share this with team members for review.

7. Publish

   When you're ready to make Valor Theme live, return to Online Store → Themes. Click the ... menu on the Valor Theme card and select Publish. Confirm, and your store is live.

Theme settings overview

The main theme-wide settings live in the Theme Editor under Theme settings (bottom of the left panel):

• Colors — set background and foreground. The whole theme adapts. Also set the input corner radius (in pixels).
• Typography — choose fonts for headings and body separately. Shopify's full font library is available, including Google Fonts and Adobe Fonts.
• Brand — used in the footer and structured data.
• Social media — links to your accounts, displayed in the footer.
• Custom CSS — for advanced customization without editing theme files.

Updating Valor Theme

When a new version is released, it's announced on the changelog page. Every Shopify theme upload installs as a new theme instance — your current theme is not overwritten or modified. Settings don't carry over automatically when uploading a new ZIP.

To update while preserving your customisations:

1. Download the new ZIP from the changelog.
2. In Shopify admin: Online Store → Themes → Add theme → Upload zip file. The new version installs alongside your current one.
3. Copy settings from your old theme. In the old theme, open the code editor and find config/settings_data.json. Copy the entire file content. In the new theme, open the same file and replace its content with what you just copied. Save.
4. Click Customize on the new theme version and review every section. Most settings will now appear, but any sections that were restructured in the new version may need reconfiguration — check the changelog for breaking changes.
5. Preview thoroughly, then publish when ready. Your old theme remains in your library as a backup.

For larger version bumps (e.g. v1.x → v2.x), the changelog may include migration notes for sections that changed. If the new version's config/settings_schema.json has substantially changed, copying settings_data.json may not work cleanly — in that case, reconfigure manually.

Common issues

The ZIP file won't upload to Shopify

Shopify has a 50 MB limit for theme ZIPs. Valor Theme is well under this, so if the upload fails, the cause is usually a corrupted download. Re-download from the link in your email and try again. If you're using a slow connection, try again on a faster network — Shopify times out partial uploads.

My customisations look broken after updating

The new theme starts from defaults if you didn't copy config/settings_data.json from your old theme — see the update guide above. If you did copy it and things still look off, a section has likely been substantially redesigned. Check the changelog for that version — breaking changes are noted explicitly. Your previous theme version remains in your library, so you can switch back if needed.

Some text is too small or hard to read

Adjust the font sizes in Theme settings → Typography. The theme uses a typography scale that you control. If you want global changes, the Custom CSS field supports overrides — see the :root CSS variables in the theme code.

The theme looks different from the demo

The demo store uses specific demo content (images, product titles, descriptions). The theme itself ships with empty sections that you populate with your own content. Refer to the demo for layout inspiration — the theme structure is the same, just with your products and images.

I'm getting errors with my Shopify apps

If a third-party app injects code into your theme, it may conflict with Valor Theme's optimization patterns (lazy-loading, async resources). Contact the app developer first — most are familiar with these patterns. If the issue persists, use the contact form and we'll investigate.

Need more help?

Use the contact form on the homepage — it's the primary way to reach us. We read every message and reply personally within a day or two.

Valor Theme's full source is available on GitHub under the Valor Free License. You can review the code there, and report reproducible bugs or compatibility issues via GitHub Issues.