Overview & core concepts
Start here. This page explains what setlist is, how it sits alongside Shopify and Fulfil, and the handful of concepts that everything else builds on.
What setlist is
setlist is the operational prep room for products you haven't launched yet. You plan a product, build its variants and SKUs, enter its bill of materials, cost it, test it, forecast it, and review it — all before it becomes a real Shopify listing. When it's ready, setlist stages it in Shopify and you list it live.
"Plan products, generate SKUs, prescribe tests, set pricing, and review them before they're created in Shopify."
How setlist fits with Shopify and Fulfil
Three systems, each owning its part:
| System | Owns |
|---|---|
| setlist | The prep: variants, SKUs, bill of materials, costs, testing, forecast, internal notes, and the readiness pipeline |
| Shopify | The listing: the official name, final photos, description, SEO, collections — and the live storefront |
| Fulfil | The source of truth for materials: stock-on-hand, unit costs, and labor |
setlist doesn't try to rebuild Shopify's product editor or Fulfil's inventory — it fills the gap before a product exists in either.
Permissions, as you go. setlist installs with minimal Shopify access and asks for more only when you push a product, list it live, sell a sample, or sync order history for forecasting. Fulfil is optional too. See Shopify access & permissions.
- Variants
- SKUs
- Bill of materials
- Costs
- Testing
- Forecast
- Readiness pipeline
- Official name
- Photos
- Description
- SEO
- Collections
- Live storefront
- Stock on hand
- Unit costs
- Labor
The core model
Product vs. Variant vs. SKU
- A Product is the design/merchandising container — the name, type, owner, launch, notes. It has an ID, but that ID is not a fulfillment key.
- A Variant is the actual sellable/fulfillable unit. It carries the SKU, the bill of materials, costs, tests, and forecast. (Everything that matters operationally lives at the variant level.)
- Every product always has at least one variant. A "simple" product has a single hidden default variant carrying its SKU — you never see the word "variant" until you add a second one.
- A product can vary on up to 3 option types (e.g. Size, Metal, Length), each with many values. The variants are the combinations.
Every product has at least one variant. The SKU and all costs live on the variant — not the product.
SKUs are generated, not typed
SKUs are built automatically from a per-product-type template plus your global prefix — e.g. R-STACK-SS. You can override a variant's SKU, but you never assemble one by hand. See Product types & SKUs.
Costs roll up; you type only the price
A variant's material cost sums its bill of materials, labor comes from Fulfil, and the two make COGS. You enter only the price; margin and a suggested price compute from there.
The pipeline
Every product moves through a fixed set of stages, each with a checklist ("gate") that must be complete before advancing:
Plan → Design → Review → Ready for launch · Archived
"Ready for launch" is as far as setlist goes — it stages the product in Shopify (unlisted) and syncs to Fulfil; you list it live.
Variants, bill of materials, costs and SKUs, then a design sign-off.
The grouping hierarchy
Products can be grouped two levels up:
Campaign → Launch → Product
- A Launch is a drop with a date range; you assign products to it.
- A Campaign groups multiple launches and products under one banner (e.g. "Summer 2026").
Two testing features (don't confuse them)
- Tests — internal QA you run yourself (tarnish test, wear test…).
- User testing — sending physical samples to real people for feedback via a hosted form.
Forecasting is versioned
Forecasts combines recent Shopify sales, older workbook history, and inventory snapshots. Generated forecasts begin as editable drafts; locking one freezes the version so future actuals can score it without rewriting the plan.
A new shop starts empty
setlist ships with no catalogs pre-loaded — you build your product types, team, launches, product lines, classifications, and so on in Settings. The jewelry examples throughout these docs (Rings, Sterling Silver, etc.) come from the optional demo data and are just illustrative.
First-time setup: work through Settings in order, then create your first product card.
Two things to know about the UI
- Most fields autosave as you type (a quiet "Saving… → Saved"). Multi-part builders and big actions use explicit buttons. See each page for which.
- Removing is immediate — trash icons delete right away, without a confirmation dialog.
Where to next
- Products — create your first product card
- The Product Workspace — the detail page, end to end
- Forecasts — sales history, forecast versions, accuracy, and planning
- Settings — set up your catalogs