[{"data":1,"prerenderedAt":464},["ShallowReactive",2],{"guidelines-meta":3,"guideline-pdp-pdp-sr-stock-01":240},[4,16,22,28,34,40,45,50,55,60,66,71,76,82,87,92,97,102,107,112,117,122,127,132,137,142,147,152,157,163,168,173,178,184,189,194,199,204,209,214,219,224,230,235],{"title":5,"category":6,"dimension":7,"severity":8,"targets":9,"status":12,"path":13,"stem":14,"shopware_status":15,"shopify_status":15},"Cart quantity value remains fully readable at all supported quantities","cart","decision-clarity","high",[10,11],"human","agent","published","\u002Fguidelines\u002Fcart\u002Fcart-dc-qty-01","guidelines\u002Fcart\u002Fcart-dc-qty-01","no_divergence",{"title":17,"category":6,"dimension":18,"severity":8,"targets":19,"status":12,"path":20,"stem":21,"shopware_status":15,"shopify_status":15},"Selected offer state persists unchanged from PDP to Cart","system-robustness",[11],"\u002Fguidelines\u002Fcart\u002Fcart-sr-persist-01","guidelines\u002Fcart\u002Fcart-sr-persist-01",{"title":23,"category":6,"dimension":18,"severity":24,"targets":25,"status":12,"path":26,"stem":27,"shopware_status":15,"shopify_status":15},"Cart quantity persists across checkout navigation","critical",[10,11],"\u002Fguidelines\u002Fcart\u002Fcart-sr-qty-01","guidelines\u002Fcart\u002Fcart-sr-qty-01",{"title":29,"category":6,"dimension":30,"severity":8,"targets":31,"status":12,"path":32,"stem":33,"shopware_status":15,"shopify_status":15},"Cart reinforces the user’s selected product decision with clear visual and attribute confirmation","trust-decision-enablement",[10],"\u002Fguidelines\u002Fcart\u002Fcart-te-reinforce-01","guidelines\u002Fcart\u002Fcart-te-reinforce-01",{"title":35,"category":36,"dimension":7,"severity":8,"targets":37,"status":12,"path":38,"stem":39,"shopware_status":15,"shopify_status":15},"Purchase restrictions are disclosed upfront","pdp",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-c-restrict-01","guidelines\u002Fpdp\u002Fpdp-c-restrict-01",{"title":41,"category":36,"dimension":7,"severity":8,"targets":42,"status":12,"path":43,"stem":44,"shopware_status":15,"shopify_status":15},"Above-the-fold decision completeness",[10],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-atf-01","guidelines\u002Fpdp\u002Fpdp-dc-atf-01",{"title":46,"category":36,"dimension":7,"severity":8,"targets":47,"status":12,"path":48,"stem":49,"shopware_status":15,"shopify_status":15},"Cognitive load per section",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-cl-01","guidelines\u002Fpdp\u002Fpdp-dc-cl-01",{"title":51,"category":36,"dimension":7,"severity":8,"targets":52,"status":12,"path":53,"stem":54,"shopware_status":15,"shopify_status":15},"Scroll-to-CTA Reinforcement",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-cta-01","guidelines\u002Fpdp\u002Fpdp-dc-cta-01",{"title":56,"category":36,"dimension":7,"severity":8,"targets":57,"status":12,"path":58,"stem":59,"shopware_status":15,"shopify_status":15},"Primary CTA state is always explainable",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-cta-02","guidelines\u002Fpdp\u002Fpdp-dc-cta-02",{"title":61,"category":36,"dimension":7,"severity":62,"targets":63,"status":12,"path":64,"stem":65,"shopware_status":15,"shopify_status":15},"Primary CTA is visually dominant","medium",[10],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-cta-vis-01","guidelines\u002Fpdp\u002Fpdp-dc-cta-vis-01",{"title":67,"category":36,"dimension":7,"severity":8,"targets":68,"status":12,"path":69,"stem":70,"shopware_status":15,"shopify_status":15},"Delivery time is explicit and state-specific",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-delivery-01","guidelines\u002Fpdp\u002Fpdp-dc-delivery-01",{"title":72,"category":36,"dimension":7,"severity":8,"targets":73,"status":12,"path":74,"stem":75,"shopware_status":15,"shopify_status":15},"Product description communicates functional understanding",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-desc-01","guidelines\u002Fpdp\u002Fpdp-dc-desc-01",{"title":77,"category":36,"dimension":7,"severity":24,"targets":78,"status":12,"path":80,"stem":81,"shopware_status":15,"shopify_status":15},"Product suitability should be clearly self-evident on the PDP",[10,11,79],"machine","\u002Fguidelines\u002Fpdp\u002Fpdp-dc-fit-01","guidelines\u002Fpdp\u002Fpdp-dc-fit-01",{"title":83,"category":36,"dimension":7,"severity":24,"targets":84,"status":12,"path":85,"stem":86,"shopware_status":15,"shopify_status":15},"Users should clearly understand what is included in the purchase",[10,11,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-off-01","guidelines\u002Fpdp\u002Fpdp-dc-off-01",{"title":88,"category":36,"dimension":7,"severity":8,"targets":89,"status":12,"path":90,"stem":91,"shopware_status":15,"shopify_status":15},"Object handling block",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-ohb-01","guidelines\u002Fpdp\u002Fpdp-dc-ohb-01",{"title":93,"category":36,"dimension":7,"severity":8,"targets":94,"status":12,"path":95,"stem":96,"shopware_status":15,"shopify_status":15},"Price anchoring presence",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-pap-01","guidelines\u002Fpdp\u002Fpdp-dc-pap-01",{"title":98,"category":36,"dimension":7,"severity":8,"targets":99,"status":12,"path":100,"stem":101,"shopware_status":15,"shopify_status":15},"Payment options and financing conditions should be clearly visible before checkout",[10,11,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-pay-01","guidelines\u002Fpdp\u002Fpdp-dc-pay-01",{"title":103,"category":36,"dimension":7,"severity":8,"targets":104,"status":12,"path":105,"stem":106,"shopware_status":15,"shopify_status":15},"The total cost and unit-based pricing of the product should be clearly understandable before purchase",[10,11,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-prc-01","guidelines\u002Fpdp\u002Fpdp-dc-prc-01",{"title":108,"category":36,"dimension":7,"severity":8,"targets":109,"status":12,"path":110,"stem":111,"shopware_status":15,"shopify_status":15},"Price visible without interaction",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-price-01","guidelines\u002Fpdp\u002Fpdp-dc-price-01",{"title":113,"category":36,"dimension":7,"severity":8,"targets":114,"status":12,"path":115,"stem":116,"shopware_status":15,"shopify_status":15},"Primary value proposition clarity",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-pvp-01","guidelines\u002Fpdp\u002Fpdp-dc-pvp-01",{"title":118,"category":36,"dimension":7,"severity":8,"targets":119,"status":12,"path":120,"stem":121,"shopware_status":15,"shopify_status":15},"Return conditions are visible before purchase",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-returns-01","guidelines\u002Fpdp\u002Fpdp-dc-returns-01",{"title":123,"category":36,"dimension":7,"severity":8,"targets":124,"status":12,"path":125,"stem":126,"shopware_status":15,"shopify_status":15},"Social proof density & placement",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-sp-01","guidelines\u002Fpdp\u002Fpdp-dc-sp-01",{"title":128,"category":36,"dimension":7,"severity":8,"targets":129,"status":12,"path":130,"stem":131,"shopware_status":15,"shopify_status":15},"Total price is determinable before checkout",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-total-01","guidelines\u002Fpdp\u002Fpdp-dc-total-01",{"title":133,"category":36,"dimension":7,"severity":8,"targets":134,"status":12,"path":135,"stem":136,"shopware_status":15,"shopify_status":15},"Urgency & momentum signals",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-ums-01","guidelines\u002Fpdp\u002Fpdp-dc-ums-01",{"title":138,"category":36,"dimension":7,"severity":8,"targets":139,"status":12,"path":140,"stem":141,"shopware_status":15,"shopify_status":15},"Variant friction index",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-var-01","guidelines\u002Fpdp\u002Fpdp-dc-var-01",{"title":143,"category":36,"dimension":7,"severity":8,"targets":144,"status":12,"path":145,"stem":146,"shopware_status":15,"shopify_status":15},"Variant selection is required before purchase when applicable",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-var-req-01","guidelines\u002Fpdp\u002Fpdp-dc-var-req-01",{"title":148,"category":36,"dimension":7,"severity":62,"targets":149,"status":12,"path":150,"stem":151,"shopware_status":15,"shopify_status":15},"Primary product information is visible above initial viewport",[10],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-viewport-01","guidelines\u002Fpdp\u002Fpdp-dc-viewport-01",{"title":153,"category":36,"dimension":7,"severity":8,"targets":154,"status":12,"path":155,"stem":156,"shopware_status":15,"shopify_status":15},"Visual proof of value",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-dc-vpv-01","guidelines\u002Fpdp\u002Fpdp-dc-vpv-01",{"title":158,"category":36,"dimension":159,"severity":24,"targets":160,"status":12,"path":161,"stem":162,"shopware_status":15,"shopify_status":15},"Structured product data aligns with visible content","machine-extractability",[11,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-me-align-01","guidelines\u002Fpdp\u002Fpdp-me-align-01",{"title":164,"category":36,"dimension":159,"severity":8,"targets":165,"status":12,"path":166,"stem":167,"shopware_status":15,"shopify_status":15},"Core product attributes are presented as structured text",[11,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-me-attr-01","guidelines\u002Fpdp\u002Fpdp-me-attr-01",{"title":169,"category":36,"dimension":159,"severity":62,"targets":170,"status":12,"path":171,"stem":172,"shopware_status":15,"shopify_status":15},"Single semantic H1 on PDP",[11,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-me-h1-01","guidelines\u002Fpdp\u002Fpdp-me-h1-01",{"title":174,"category":36,"dimension":7,"severity":8,"targets":175,"status":12,"path":176,"stem":177,"shopware_status":15,"shopify_status":15},"Related product variants are clearly discoverable and cross-linked",[10],"\u002Fguidelines\u002Fpdp\u002Fpdp-merch-variant-01","guidelines\u002Fpdp\u002Fpdp-merch-variant-01",{"title":179,"category":36,"dimension":180,"severity":24,"targets":181,"status":12,"path":182,"stem":183,"shopware_status":15,"shopify_status":15},"Canonical Product & Offer Identity","semantic-integrity",[10,11,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-mi-id-01","guidelines\u002Fpdp\u002Fpdp-mi-id-01",{"title":185,"category":36,"dimension":180,"severity":62,"targets":186,"status":12,"path":187,"stem":188,"shopware_status":15,"shopify_status":15},"Product claims are supported by concrete evidence",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-si-claims-01","guidelines\u002Fpdp\u002Fpdp-si-claims-01",{"title":190,"category":36,"dimension":180,"severity":24,"targets":191,"status":12,"path":192,"stem":193,"shopware_status":15,"shopify_status":15},"No contradictory product information across the PDP",[10,11,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-si-consist-01","guidelines\u002Fpdp\u002Fpdp-si-consist-01",{"title":195,"category":36,"dimension":180,"severity":62,"targets":196,"status":12,"path":197,"stem":198,"shopware_status":15,"shopify_status":15},"Product imagery matches selected variant",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-si-image-01","guidelines\u002Fpdp\u002Fpdp-si-image-01",{"title":200,"category":36,"dimension":180,"severity":8,"targets":201,"status":12,"path":202,"stem":203,"shopware_status":15,"shopify_status":15},"Variant selection does not redefine product identity",[11,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-si-var-01","guidelines\u002Fpdp\u002Fpdp-si-var-01",{"title":205,"category":36,"dimension":18,"severity":8,"targets":206,"status":12,"path":207,"stem":208,"shopware_status":15,"shopify_status":15},"Availability status rendered as text in DOM",[11,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-sr-avail-01","guidelines\u002Fpdp\u002Fpdp-sr-avail-01",{"title":210,"category":36,"dimension":18,"severity":24,"targets":211,"status":12,"path":212,"stem":213,"shopware_status":15,"shopify_status":15},"Default PDP State Is Valid",[10,11,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-sr-def-01","guidelines\u002Fpdp\u002Fpdp-sr-def-01",{"title":215,"category":36,"dimension":18,"severity":8,"targets":216,"status":12,"path":217,"stem":218,"shopware_status":15,"shopify_status":15},"PDP loads core decision data without delay",[10,11],"\u002Fguidelines\u002Fpdp\u002Fpdp-sr-load-01","guidelines\u002Fpdp\u002Fpdp-sr-load-01",{"title":220,"category":36,"dimension":18,"severity":24,"targets":221,"status":12,"path":222,"stem":223,"shopware_status":15,"shopify_status":15},"Price is rendered as authoritative text in DOM",[10,11,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-sr-price-01","guidelines\u002Fpdp\u002Fpdp-sr-price-01",{"title":225,"category":36,"dimension":18,"severity":24,"targets":226,"status":12,"path":227,"stem":228,"shopware_status":229,"shopify_status":229},"Stock status reflects real purchasability",[10,11,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-sr-stock-01","guidelines\u002Fpdp\u002Fpdp-sr-stock-01","platform_specific",{"title":231,"category":36,"dimension":30,"severity":8,"targets":232,"status":12,"path":233,"stem":234,"shopware_status":15,"shopify_status":15},"Fulfillment expectations are clearly communicated and structurally supported",[10,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-td-ful-01","guidelines\u002Fpdp\u002Fpdp-td-ful-01",{"title":236,"category":36,"dimension":30,"severity":8,"targets":237,"status":12,"path":238,"stem":239,"shopware_status":15,"shopify_status":15},"Product reviews should provide meaningful information that helps users make a confident purchase decision",[10,11,79],"\u002Fguidelines\u002Fpdp\u002Fpdp-td-rev-01","guidelines\u002Fpdp\u002Fpdp-td-rev-01",{"id":241,"title":225,"body":242,"category":36,"description":448,"dimension":18,"extension":458,"meta":459,"navigation":460,"path":227,"seo":461,"severity":24,"shopify_status":229,"shopware_status":229,"status":12,"stem":228,"targets":462,"__hash__":463},"guidelines\u002Fguidelines\u002Fpdp\u002Fpdp-sr-stock-01.md",{"type":243,"value":244,"toc":447},"minimark",[245,250,254,258,261,265,278,282,288,292,295,299,315,320,332,339,349,352,356,359,362,372,401,429,435,441,444],[246,247,249],"h2",{"id":248},"what-is-being-checked","What is being checked",[251,252,253],"p",{},"Checks whether displayed stock status accurately reflects actual purchase capability.",[246,255,257],{"id":256},"why-it-matters","Why it matters",[251,259,260],{},"When stock information is unreliable, transactions fail and system credibility is severely damaged.",[246,262,264],{"id":263},"failure-signals","Failure signals",[266,267,268,272,275],"ul",{},[269,270,271],"li",{},"In stock but cannot purchase",[269,273,274],{},"Out of stock but purchasable",[269,276,277],{},"Stock updates too late",[246,279,281],{"id":280},"how-to-verify","How to verify",[283,284,285],"ol",{},[269,286,287],{},"Attempt checkout with the displayed stock state and confirm consistency.",[246,289,291],{"id":290},"recommended-fix","Recommended fix",[251,293,294],{},"Synchronize stock indicators with real-time purchase logic.",[246,296,298],{"id":297},"shopware-specific","Shopware specific",[251,300,301,302,306,307,310,311,314],{},"Stock mismatches usually originate in product data, not in the template.\nShopware only runs a stock update when one of three fields changes: ",[303,304,305],"code",{},"stock",",\n",[303,308,309],{},"isCloseout",", ",[303,312,313],{},"minPurchase",". These are the fields to check first.",[251,316,317,319],{},[303,318,309],{}," (admin: Clearance sale) — off by default on a new product. With it\noff, the product remains orderable past zero stock; the product definition\ndescribes the enabled state as hiding the product when sold out. Since Stock\nalso defaults to 0, a newly created or imported product is orderable with no\nstock present unless this is changed. This is the most common source of the \"out\nof stock but purchasable\" signal after bulk imports.",[251,321,322,324,325,328,329,331],{},[303,323,313],{}," \u002F ",[303,326,327],{},"purchaseSteps"," (admin: Min. order quantity, Purchase steps) — a\nproduct with stock 1 and ",[303,330,313],{}," 2 renders as available but cannot be\nadded to the cart, usually with no error state in the DOM.",[251,333,334,335,338],{},"Version boundary: from 6.6.0.0, ",[303,336,337],{},"product.stock"," is the primary real-time source\nand the Available Stock field mirrors it — both values are always identical, and\nthe field is read-only in the admin. Before 6.6.0.0 a different model applied,\nin which available stock was derived from open orders. On shops below 6.6,\nverify which of the two values the template and any product feed actually read.",[251,340,341,342,345,346,348],{},"Stock management can be disabled entirely\n(",[303,343,344],{},"shopware.stock.enable_stock_management: false","). With it off, ",[303,347,337],{},"\nis not updated when orders are placed or completed, and displayed stock drifts\nfrom reality until an external system writes it back. Confirm whether an ERP or\ninventory system owns stock before treating a mismatch as a storefront defect.",[251,350,351],{},"Variants are separate product entities with their own stock. Verify at variant\nlevel, not on the parent.",[246,353,355],{"id":354},"shopify-specific","Shopify specific",[251,357,358],{},"Purchasability is decided per variant, not per product. A product can appear\navailable while the selected variant is not orderable.",[251,360,361],{},"Two settings interact, both in the product's Inventory section:",[251,363,364,367,368,371],{},[303,365,366],{},"Track quantity"," (",[303,369,370],{},"inventory_management",") — when off, quantity values are not\nenforced. Displayed quantity and actual purchasability become unrelated.",[251,373,374,367,377,380,381,384,385,388,389,392,393,396,397,400],{},[303,375,376],{},"Continue selling when out of stock",[303,378,379],{},"inventory_policy",") — with ",[303,382,383],{},"CONTINUE",",\ncustomers can buy the variant after it is out of stock; with ",[303,386,387],{},"DENY"," they cannot.\nInventory goes negative and no sold-out state appears. In a product CSV this is\nthe column ",[303,390,391],{},"Variant Inventory Policy"," with the values ",[303,394,395],{},"continue"," or ",[303,398,399],{},"deny",".\nFrequently enabled in bulk during migrations or by inventory apps.",[251,402,403,404,306,407,410,411,414,415,418,419,422,423,425,426,428],{},"Machine-readable gap: the Storefront API exposes ",[303,405,406],{},"availableForSale",[303,408,409],{},"currentlyNotInStock"," and ",[303,412,413],{},"quantityAvailable"," on ",[303,416,417],{},"ProductVariant",", but not\n",[303,420,421],{},"inventoryPolicy"," — that field exists only in the Admin API. A headless\nfrontend, feed or agent reading ",[303,424,406],{}," alone cannot distinguish real\nstock from continue-selling at zero. Read ",[303,427,413],{}," alongside it.",[251,430,431,432,434],{},"Policy is variant-level, not location-level. With multiple locations, ",[303,433,395],{},"\nmeans selling continues once total inventory across all locations reaches zero;\nthere is no native per-location toggle for the online store.",[251,436,437,438,440],{},"Point of sale is excluded from ",[303,439,395],{},": the setting governs the online store\nonly. A variant at zero can be purchasable online and refused at POS. This is\nintended behaviour, not a mismatch.",[251,442,443],{},"Themes typically render availability from the variant object in the initial HTML\nand update it client-side on variant change. Verify the rendered state after\nswitching variants, not only on page load.",[251,445,446],{},"Third-party inventory or pre-order apps override the native state. Where such an\napp is installed, displayed availability may come from the app rather than the\nvariant, and the two can diverge.",{"title":448,"searchDepth":449,"depth":449,"links":450},"",2,[451,452,453,454,455,456,457],{"id":248,"depth":449,"text":249},{"id":256,"depth":449,"text":257},{"id":263,"depth":449,"text":264},{"id":280,"depth":449,"text":281},{"id":290,"depth":449,"text":291},{"id":297,"depth":449,"text":298},{"id":354,"depth":449,"text":355},"md",{},true,{"title":225,"description":448},[10,11,79],"XvkfHMZdg-a19gt1bA61UU8WiU8OpCElelq1i8Mj5pk",1786800992140]