Woo Dynamic Data Tree

Woo product dynamic data is exposed under omewoo on Etch post data when the post is a Woo product.

Use the same tree with different prefixes depending on context:

Context	Prefix
Product archive or product loop	{item.omewoo...}
Single product template	{this.omewoo...}

The examples below use {this.omewoo...}. In a product loop, replace this with item.

Product Tree

Expression	Type	Meaning
{this.omewoo.productType}	string	Woo product type, such as simple or variable.
{this.omewoo.productId}	number	Woo product ID.
{this.omewoo.priceText}	string	Formatted current product price text.
{this.omewoo.stockStatus}	string	Woo stock status.
{this.omewoo.available}	boolean	true when the product is purchasable and in stock.
{this.omewoo.product.id}	number	Product identity ID.
{this.omewoo.product.type}	string	Product identity type. Use this for AddToCartForm.product.product_type.
{this.omewoo.product.sku}	string	Product SKU.
{this.omewoo.product.name}	string	Product display name.

The top-level values are convenience aliases. The grouped objects are the more descriptive structure.

Price Tree

Expression	Type	Meaning
{this.omewoo.price.currencyCode}	string	Store currency code.
{this.omewoo.price.currencySymbol}	string	Decoded store currency symbol.
{this.omewoo.price.raw}	string	Raw Woo price.
{this.omewoo.price.regular}	string	Raw regular price.
{this.omewoo.price.sale}	string	Raw sale price.
{this.omewoo.price.text}	string	Formatted price text.

The demo archive and single-product patterns use {item.omewoo.price.text} and {this.omewoo.price.text} for visible price copy.

Media Tree

Expression	Type	Meaning
{this.omewoo.media.image.id}	number	Attachment ID, or 0 when no attachment is available.
{this.omewoo.media.image.url}	string	Full image URL.
{this.omewoo.media.image.alt}	string	Attachment alt text, falling back to product or variant name.
{this.omewoo.media.image.title}	string	Attachment title.
{this.omewoo.media.image.caption}	string	Attachment caption.
{this.omewoo.media.image.description}	string	Attachment description.
{this.omewoo.media.image.filename}	string	Image filename.
{this.omewoo.media.image.srcset}	string	WordPress image srcset.
{this.omewoo.media.image.width}	number	Full image width.
{this.omewoo.media.image.height}	number	Full image height.
{this.omewoo.media.image.filesize}	number	Attachment filesize when available.
{this.omewoo.media.image.mime_type}	string	Attachment MIME type.
{this.omewoo.media.image.sizes.full.url}	string	Full-size URL when WordPress provides it.
{this.omewoo.media.image.sizes.full.width}	number	Full-size width.
{this.omewoo.media.image.sizes.full.height}	number	Full-size height.

sizes is keyed by registered WordPress image size names. Common keys include thumbnail, medium, large, and full, but the available keys depend on the site.

Purchase Tree

Expression	Type	Meaning
{this.omewoo.purchase.available}	boolean	Product can be purchased and is in stock.
{this.omewoo.purchase.purchasable}	boolean	Woo says the product is purchasable.
{this.omewoo.purchase.inStock}	boolean	Woo says the product is in stock.
{this.omewoo.purchase.stockStatus}	string	Woo stock status.

AddToCartForm uses these values through its availability props. If the product is unavailable, the form disables its submit controls at runtime.

Attribute Tree

Variable products expose variation attributes under omewoo.attributes. Simple products intentionally expose an empty array.

Loop target:

{#loop this.omewoo.attributes as attribute}
  ...
{/loop}

Each attribute row has this shape:

Expression	Type	Meaning
{attribute.key}	string	Store API variation attribute key, such as attribute_pa_color.
{attribute.taxonomy}	string	Woo taxonomy or local attribute name, such as pa_color.
{attribute.label}	string	Human-readable attribute label.
{attribute.required}	boolean	Current implementation marks variation attributes as required.
{attribute.options}	array	Selectable option rows for AttributeSelector.

AttributeSelector expects the whole attribute object:

<OmeWooAttributeSelector target='{{"attribute":{attribute}}}' />

Attribute Option Tree

Inside an attribute, options are available as attribute.options. AttributeSelector loops this tree internally through props.target.attribute.options, but authors can also inspect it in custom loops.

Expression	Type	Meaning
{option.label}	string	Option display label.
{option.value}	string	Option slug sent as the selected variation value.
{option.variationId}	number	Variation ID when a single-attribute product can map the option to one variant; otherwise 0.
{option.priceText}	string	Variant price text when available from a single-attribute variant.
{option.available}	boolean	Whether the mapped option is available.
{option.stockStatus}	string	Mapped variant stock status.
{option.image}	object	Image payload using the same image shape as media.image.

Runtime copies option availability into data-ome-available, data-ome-unavailable, and data-ome-stock-status so unavailable variation choices can disable the parent form.

Variant Tree

Variable products expose all variation payloads under omewoo.variants. Simple products intentionally expose an empty array.

Expression	Type	Meaning
{variant.id}	number	Variation product ID.
{variant.label}	string	Label built from selected variation attribute values.
{variant.sku}	string	Variation SKU.
{variant.priceText}	string	Formatted variation price text.
{variant.regularPrice}	string	Raw regular variation price.
{variant.available}	boolean	Variation can be purchased and is in stock.
{variant.stockStatus}	string	Variation stock status.
{variant.product.id}	number	Variation identity ID.
{variant.product.type}	string	Variation product type.
{variant.product.sku}	string	Variation SKU from the nested identity object.
{variant.product.name}	string	Variation display name.
{variant.price.*}	object	Same price tree as product omewoo.price.
{variant.media.image.*}	object	Same image tree as product omewoo.media.image.
{variant.purchase.*}	object	Same purchase tree as product omewoo.purchase.
{variant.attributes.attribute_pa_color}	string	Selected value for a variation attribute key. Actual keys depend on the product.
{variant.image.*}	object	Legacy flat image alias retained for existing dynamic-data consumers.

The variation attributes object is keyed by Store API variation attribute names. For taxonomy attributes this is typically attribute_pa_{slug}.

Common Product Bindings

Use case	Product loop	Single product
Product ID	{item.id} or {item.omewoo.productId}	{this.id} or {this.omewoo.productId}
Product type	{item.omewoo.product.type}	{this.omewoo.product.type}
Product image URL	{item.omewoo.media.image.url}	{this.omewoo.media.image.url}
Product image alt	{item.omewoo.media.image.alt}	{this.omewoo.media.image.alt}
Product price	{item.omewoo.price.text}	{this.omewoo.price.text}
Variation attributes loop	item.omewoo.attributes	this.omewoo.attributes

Use item inside loops and this on single product templates. If this.omewoo.attributes is empty in preview, confirm the preview product is a variable product.

Related Cart Source Trees

These are not under omewoo, but they are the other Woo dynamic sources authors can target directly.

cartItems

Loop target:

{#loop cartItems as item}
  ...
{/loop}

Expression	Type	Meaning
{item.key}	string	Woo cart item key.
{item.productId}	number	Product ID.
{item.title}	string	Composed title, including selected variation labels when present.
{item.productTitle}	string	Parent product title.
{item.titleParts}	array	Title parts used to compose title.
{item.attributes}	array	Selected cart item attribute rows.
{item.quantity}	number	Cart item quantity.
{item.url}	string	Product permalink.
{item.priceRaw}	string	Raw unit price.
{item.priceText}	string	Formatted unit price text.
{item.subtotalRaw}	string	Raw line subtotal.
{item.subtotalText}	string	Formatted line subtotal text.
{item.media.image.*}	object	Current item image payload.
{item.image.*}	object	Legacy flat image alias retained for existing dynamic-data consumers.

Each item.attributes row has:

Expression	Type	Meaning
{attribute.key}	string	Attribute taxonomy key.
{attribute.name}	string	Human-readable attribute name.
{attribute.taxonomy}	string	Attribute taxonomy.
{attribute.value}	string	Human-readable selected attribute value.

cartSummary

Expression	Type	Meaning
{cartSummary.item_count}	number	Sum of cart quantities.
{cartSummary.line_count}	number	Number of cart lines.
{cartSummary.state}	string	has-items or empty.

cartTotals

Expression	Type	Meaning
{cartTotals.total_price}	string	Raw final total.
{cartTotals.totalPriceText}	string	Formatted final total.
{cartTotals.total_items}	string	Raw subtotal/items total.
{cartTotals.totalItemsText}	string	Formatted subtotal/items total.
{cartTotals.total_discount}	string	Raw discount total.
{cartTotals.totalDiscountText}	string	Formatted discount total.
{cartTotals.total_shipping}	string	Raw shipping total.
{cartTotals.totalShippingText}	string	Formatted shipping total.
{cartTotals.total_tax}	string	Raw tax total.
{cartTotals.totalTaxText}	string	Formatted tax total.

cartCoupons

Expression	Type	Meaning
{coupon.code}	string	Applied coupon code.

Related Selector Source Trees

shippingRates

Loop target:

{#loop shippingRates as rate}
  ...
{/loop}

Expression	Type	Meaning
{rate.key}	string	Package-aware key in {package_id}:{rate_id} form.
{rate.package_id}	number	Shipping package index or package ID.
{rate.rate_id}	string	Raw Woo shipping rate ID.
{rate.name}	string	Shipping rate label.
{rate.description}	string	Shipping rate description.
{rate.price}	string	Raw shipping cost.
{rate.priceText}	string	Formatted shipping cost.
{rate.selected}	boolean	Whether Woo currently has the rate selected for the package.

paymentMethods

Loop target:

{#loop paymentMethods as method}
  ...
{/loop}

Expression	Type	Meaning
{method.id}	string	Payment gateway ID.
{method.label}	string	Payment gateway label.
{method.description}	string	Payment gateway description.
{method.selected}	boolean	Whether Woo currently has this gateway selected.

Only enabled simple gateways are included. Gateways with custom embedded fields are skipped by this source.