Overview of the public window.Measura storefront API for Shopify theme integrations.
The public storefront surface is exposed as window.Measura. This API is intended for Shopify theme code that needs to build Measura-compatible line item properties, read Measura cart measurements, react to Measura block events, or coordinate mounted product blocks on the page.
Not every window.Measura method has the same availability. Shared storefront methods only require the shared runtime to be loaded, while block methods require at least one Measura product block to be rendered and initialized.
These methods do not require a mounted Measura product block.
| Method | Async | Requires rendered Measura block |
|---|---|---|
| buildLineItemProperties(options) | Yes | No |
| buildLineItemPropertiesBulk(items) | Yes | No |
| getProduct(options) | Yes | No |
| getVariant(options) | Yes | No |
| getCartItemMeasurementByKey(lineItemKey, options?) | No | No |
These methods are exposed by the Measura product block runtime and require at least one rendered Measura block.
| Method | Async | Requires rendered Measura block |
|---|---|---|
| setVariant(payload) | No | Yes |
| getRegisteredProductIds() | No | Yes |
| addEventListener(eventName, callback, options?) | No | Yes |
| removeEventListener(eventName, callback, options?) | No | Yes |
Build Measura line item properties with the shared storefront runtime.
Read public Measura product and variant configuration from the shared storefront runtime.
Read normalized Measura measurements from Shopify cart line items.
Control mounted Measura blocks and subscribe to block runtime events.