Regimen — merchant documentation
A supplements / wellness theme where subscription is the default state of the buy box, with structured, accessible supplement facts rendered from your data. This guide covers setup end to end. No coding required.
- Support: hello@zorzen.xyz
- Theme version: 1.0.0
1. Install & first run
- From the Theme Store, Add Regimen. Open Online Store → Themes → Customize.
- Set logo and colors in Theme settings, and choose a style in Theme settings → Presets.
Styles (presets)
| Style | What changes |
|---|---|
| Meridian | Default — sage accent, warm bone ground |
| Clay | Accent → terracotta |
| Slate | Accent → muted blue, cooler ground |
The compliance-slate accent (used for all trust/regulatory UI) is fixed across every style by design.
2. Header, announcement & footer
Header and footer are section groups.
- Header → logo (or blank for a text wordmark), menu, search toggle.
- Announcement bar → e.g. "Every batch third-party tested".
- Footer → left text + link blocks.
3. Subscriptions (the core feature)
Regimen's buy box makes Subscribe & save the default, with the cadence chosen inside the selected card and a CTA that recomputes ("Subscribe — $34, every 30 days"). It renders from standard selling plans, so it works with the free Shopify Subscriptions app.
Setup:
- Install Shopify Subscriptions (Shopify App Store, free).
- Create a subscription plan: choose a discount (e.g. 15%) and delivery frequencies (e.g. every 4 / 6 / 8 weeks).
- Apply the plan to your products. The buy box automatically shows the subscription option as default, with one-time purchase as the secondary choice.
- No theme setup needed — if a product has selling plans, the subscription UI appears; if it doesn't, the buy box cleanly shows one-time only.
Any subscription app that uses Shopify's native selling-plan groups will work. Cadence labels and prices come from your plan, not the theme.
4. Supplement facts (accessible)
The facts panel renders from structured metafield data as a real, screen-reader-accessible table — never a flattened label image.
Product metafields:
| Metafield | Type | Example |
|---|---|---|
regimen.supplement_facts | JSON list of {name, amount, dv} | [{"name":"Magnesium (bisglycinate)","amount":"312 mg","dv":"74%"}] |
regimen.serving_size | Text | 2 capsules |
regimen.servings_per | Text/Number | 30 |
regimen.facts_footnote | Text | † Daily Value not established. |
Add a page with the page.facts template (or use the Facts panel section) and pick the product. Ingredient "argued-for" cards (name, dose, form, why, source, citation) are section blocks you add in the editor — no metafield needed.
5. Compliance: lots & COAs
| Metafield | Type | Purpose |
|---|---|---|
regimen.lot_number | Text | Batch/lot shown on the facts panel |
regimen.lot_date | Text/Date | Date the lot was tested |
regimen.lot_tested | Boolean | "Lot tested" badge |
regimen.coa_url | URL | Links the "View COA" button |
These render in the fixed compliance-slate color so trust UI reads consistently across all styles.
6. Other product metafields (optional)
| Metafield | Type | Used for |
|---|---|---|
regimen.tagline | Text | Short product tagline |
regimen.benefit | Text | Benefit line (Newsreader serif) |
regimen.format_line | Text | e.g. "60 capsules · 30-day supply" |
regimen.ingredients | Text/JSON | Ingredient summary |
regimen.pairs_with | Product ref | "Pairs with" / cart-drawer suggestion |
regimen.reviewer | Text | Reviewer/expert attribution |
Create all definitions once in Settings → Custom data → Products. Everything is optional and degrades gracefully.
7. Type rule
Regimen pairs Newsreader (benefit language only) with Archivo (all facts, dosage, data). The theme keeps serif and grotesk in separate blocks by design — keep benefit copy in benefit fields and factual copy in fact fields for the intended look.
8. Templates included
Home, collection, product, cart (+ drawer), blog, article, list-collections, search, page, facts page, gift card, 404, password, and all customers/* pages. Every section can be moved, duplicated, or removed safely.
9. Accessibility & performance
- WCAG 2.1 AA; supplement facts use a semantic
<table>with proper headers; visible focus ring; motion respects "reduce motion". - Vanilla JavaScript, no libraries,
defer-loaded. One hero image max above the fold. - Add to cart, subscribe, filtering, and pagination work without JavaScript.
10. FAQ
Which subscription app? The free Shopify Subscriptions app, or any app using native selling-plan groups.
Facts table is empty. Ensure the product has a valid regimen.supplement_facts JSON value and the Facts panel section points at that product.
Do I have to use serif and grotesk as prescribed? It's the designed look, but fonts are font_picker settings you can change.
Checkout styling? Checkout is Shopify-owned; only logo/colors are themeable there.
Questions? hello@zorzen.xyz