Commerce concepts
Commerce concepts
Use these pages to understand how Thor models commerce before choosing implementation details. For an ordered task with API examples, use Developer guides. For the overall product model, read How Thor fits together.
Model the catalog
| Decision | Read |
|---|---|
| What belongs to the product or the sellable option? | Products and variants |
| How should reusable options be represented? | Attributes |
| Is this a browse hierarchy or a curated group? | Categories and Collections |
| Why is an item missing or unavailable? | Catalog visibility |
| Which variant owns an image? | Product media |
| Where do translated or custom values belong? | Translations and Metafields |
Configure commercial context
| Decision | Read |
|---|---|
| What should markets share? | Stores and channels |
| How do market and customer prices differ? | Prices and price selection |
| How should amounts be displayed? | Money and rounding and Taxes |
| What stock can a buyer purchase? | Stock and availability |
| What happens between cart, order, and shipment? | Allocation and inventory lifecycle |
| How do buyer identity and commercial groups differ? | Customers and customer groups |
Understand checkout and operations
Read Carts and line items, calculation, and order placement for the purchase lifecycle. Use Shipping, Payments, and Discounts for the rules that contribute to it. After placement, use Orders and Fulfillments. Draft orders cover administrator-assisted purchases.
Build reliable API clients
Start with Authentication, GraphQL basics, and Storefront request context. Use Pagination, Typed IDs, and Errors and retries for shared client behavior.
Search query language describes resource filtering. Predicate language describes commerce-rule conditions, with separate cart and product-price contexts.