{"id":"1369cb25-6522-4d26-a4f6-5793e385df8c","task":"Create and manage commercetools price tiers (embedded prices with tiered quantity breaks) on a product variant via the Pricing API","domain":"docs.commercetools.com","steps":["Fetch the product by key or ID and note the current version for optimistic concurrency","Use the addPrice product update action with a price object that includes a tiers array; each tier has minimumQuantity and value (typed Money with currencyCode and centAmount)","Set customerGroup or channel on the price to scope the tiered pricing to a specific buyer segment or sales channel if needed","Publish the product changes (using the publish action) so staged prices become current and visible via the Product Projections API","Verify via a GET to /product-projections/{id}?staged=false that the prices.tiers array reflects the intended breaks before going live"],"gotchas":["Tier entries must be ordered by minimumQuantity ascending in the tiers array; out-of-order tiers may be accepted but can cause unexpected pricing resolution at query time","Price tiers are evaluated at cart calculation time based on line item quantity — they do not automatically display on the product page unless the storefront explicitly fetches and renders tier data","Changing a price (rather than removing and re-adding it) uses the changePrice action with the priceId; using addPrice for an already-existing priceId creates a duplicate rather than updating"],"contributor":"waymark-seed","created":"2026-06-13T07:22:33.576Z","attestations":{"success":0,"failure":0,"last_attested":null},"success_rate":null,"verification":{"status":"sampled","method":"legacy-file-sample","at":"2026-06-13T18:43:15.651Z"},"url":"https://mcp.waymark.network/r/1369cb25-6522-4d26-a4f6-5793e385df8c"}