Give individual variations their own URLs and product cards.
Updated
Some products have variations that deserve their own pages — like different strains of a flower product, or different flavors of an edible. Instead of one product page with a dropdown, each variation gets its own URL, its own SEO metadata, and appears as a separate card in product grids.
There are two ways to enable this:
custom_fields.per_variation = true on the product. Every variation expands into its own card in listings.use_as_product_page = true on individual ProductAttributeOption records. Only those variations get their own pages.Variation pages live under their category path:
/{parent-category}/{child-category}/{variation-slug}
Example: /thca-flower/indoor/blue-dream
The variation slug comes from the ProductAttributeOption.slug field.
When listing products, variations with their own pages appear as separate cards. The API sets is_variation_page: true and url_slug includes the full category path.
const { products } = await dash.products.list({ category: "indoor" })
// A per_variation product expands into multiple cards:
// [
// { name: "Blue Dream", slug: "blue-dream", url_slug: "thca-flower/indoor/blue-dream", is_variation_page: true },
// { name: "Wedding Cake", slug: "wedding-cake", url_slug: "thca-flower/indoor/wedding-cake", is_variation_page: true },
// ]
When rendering a variation page, the API returns the full parent product data with the specific variation pre-selected. Use product.variation_slug to identify which variation is active.
const { product } = await dash.products.getCore("blue-dream")
if (product.is_variation_page) {
// product.product_slug = parent product slug (for fetching options)
// product.variation_slug = this variation's slug
const { options } = await dash.products.getOptions(product.product_slug)
}
When a variation's slug changes, the backend creates a VariationRedirect record. The storefront should handle 301 redirects for old variation slugs. The API returns redirect_to in the error response when a redirect is available.