Deeproots Help Documentation Help Center

Page Builder: Breakdance

Setting Breakdance up with the plugin, the dynamic fields available, and building product listings, single product pages and offer layouts.

Updated October 1, 2026

Breakdance has the fullest field coverage of the three supported builders — including a dedicated offers group — with one important limitation around term loops that this article explains.

Setting up

Nothing to install. When Breakdance is active, the plugin registers three dynamic data groups automatically.

To confirm:

  1. Edit any page with Breakdance.
  2. Add a Text element.
  3. Click the dynamic data icon.
  4. Look for AIQ Ecommerce Products, AIQ Ecommerce Brands and AIQ Ecommerce Offers in the list.
The Breakdance dynamic data picker showing the Dispense Products, Dispense Brands and Dispense Offers groups.
The Breakdance dynamic data picker showing the AIQ Ecommerce Products, AIQ Ecommerce Brands and AIQ Ecommerce Offers groups.

If they are missing, check both plugins are active and clear Breakdance’s cache at Breakdance → Settings → Performance → Regenerate CSS.

Available dynamic fields

AIQ Ecommerce Products

Available on product pages and in a post loop over dispense_product.

Label Field key Type
Price dispense_product_price String
Quantity dispense_product_quantity String
Menu Link dispense_product_menu_link URL
Offer Details dispense_product_offer String
Product Image URL dispense_product_image_url String
Product Sale Price dispense_product_sale_price String

AIQ Ecommerce Brands

Available on product pages and in the Term Loop Builder.

Label Field key Type
Brand Image URL dispense_brand_image_url Image
Brand Name dispense_brand_name String

AIQ Ecommerce Offers

Available on the offer archive, in a term loop over dispense_offer, and on product pages, where they use the product’s first assigned offer.

Label Field key Type
Offer Name dispense_offer_name String
Offer Type dispense_offer_type String
Deal Type dispense_offer_deal_type String
Offer Description dispense_offer_description String
Offer Image dispense_offer_image Image
Offer Banner dispense_offer_banner Image
Banner (Desktop) dispense_offer_banner_large Image
Banner (Tablet) dispense_offer_banner_medium Image
Banner (Mobile) dispense_offer_banner_small Image
Banner Link dispense_offer_banner_link URL

ACF fields

The offer fields are also exposed as an ACF field group called AIQ Ecommerce Offer Details on the offer taxonomy, so they appear in Breakdance’s ACF dynamic data source alongside everything else.

They are virtual, resolved from term data when read:

ACF field Resolves to
dispense_offer_name_resolved The offer term's name
dispense_offer_type_resolved Offer type
dispense_offer_image_resolved Offer image, falling back to the desktop banner
dispense_offer_banner_resolved Banner: large → medium → small → offer image
dispense_offer_description_resolved Offer description

These resolve only where there is a real offer context — the single /offers/{slug}/ page. On a page with no offer, they are empty.

Taxonomies

Use the Terms element and select the taxonomy: dispense_brand, dispense_category, dispense_cannabis_type, dispense_terpenes, dispense_offer, dispense_venue_tax.

The Term Loop limitation

This is the one thing that catches people out, so it is worth stating plainly.

Breakdance hands a term loop only its own built-in fields — essentially the term title. It never passes the loop’s current term to custom dynamic fields, whether they are the plugin’s native tags or its ACF fields. So a term loop over offers gives you offer names, and every banner comes out empty.

This is a Breakdance limitation, not something the plugin can work around from inside the loop.

The solution is [dispense_offers], which resolves every offer on the server and returns a complete grid with banners, names and type badges.

Building Use
A list of all offers [dispense_offers]
A single offer page Dynamic fields — they work perfectly
A single offer's banner anywhere [dispense_offer_banner] or the Offer Banner field

The same caution applies to brand term loops: use [dispense_brand_image] in a Shortcode element, which resolves the brand server-side.

Building a product listing

  1. Add a Post Loop Builder element.
  2. Set Post Type to AIQ Ecommerce Product.
  3. Set posts per page — 12 or 24.
  4. Design the card in the loop template.
The Breakdance Post Loop Builder query settings with Post Type set to Dispense Product.
The Breakdance Post Loop Builder query settings with Post Type set to AIQ Ecommerce Product.

The card

Element Dynamic data
Image AIQ Ecommerce Products → Product Image URL
Heading Post → Title
Text AIQ Ecommerce Products → Price
Text AIQ Ecommerce Products → Product Sale Price (conditional)
Text AIQ Ecommerce Products → Offer Details (conditional)
Terms dispense_brand
Button Post → Permalink (Full storefront) or AIQ Ecommerce Products → Menu Link (Sync only)
A product card in the Breakdance loop builder with dynamic fields bound.
A product card in the Breakdance loop builder with dynamic fields bound.

Filtering the loop

In the loop’s query settings, add a taxonomy filter:

To show Taxonomy
One category dispense_category
One brand dispense_brand
One location dispense_venue_tax
One offer dispense_offer
On sale dispense_category → Sale

To sort by price, order by Meta value (number) on dispense_product_price.

Conditions

Show only when Condition
On sale Product Sale Price is not empty
Has an offer Offer Details is not empty
In stock Quantity is greater than 0

With the shortcode instead

A Shortcode element containing [custom_product_filter show_filters="true"] gives you the built-in filters.

Building a single product page

  1. Go to Breakdance → Templates.
  2. Create a Singular template.
  3. Set the condition to the AIQ Ecommerce Product post type.
The Breakdance template condition dialog set to the Dispense Product post type.
The Breakdance template condition dialog set to the AIQ Ecommerce Product post type.

A workable layout

Left column

Image element → Dynamic → AIQ Ecommerce Products → Product Image URL Right column

Element Content
Heading Post → Title
Terms dispense_brand
Text AIQ Ecommerce Products → Price
Text AIQ Ecommerce Products → Product Sale Price (conditional)
Terms dispense_cannabis_type
Text AIQ Ecommerce Products → Offer Details (conditional)
Shortcode [dispense_product_quantity_buttons]
Shortcode [dispense_add_to_cart]

Below

An Accordion or Tabs element, one Shortcode element per pane:

Pane Content
Description Post → Content
Cannabinoids [dispense_product_cannabinoids]
Terpenes [dispense_product_terpenes]
Effects [dispense_product_effects]
A finished single product template in Breakdance.
A finished single product template in Breakdance.

In Sync only mode

Replace the add-to-cart shortcode with a Button linked to AIQ Ecommerce Products → Menu Link.

Building offer layouts

An all-offers page

  1. Create a page.
  2. Add a Shortcode element.
  3. Enter [dispense_offers columns="3" hide_empty="1"].
  4. Set AIQ Ecommerce Products → API Settings → General → Offers Index Page to that page’s slug.
  5. Flush permalinks at Settings → Permalinks → Save Changes.

Not a Term Loop Builder — see the limitation above.

The front-end all-offers page rendered by [dispense_offers].
The front-end all-offers page rendered by [dispense_offers].

A single offer page

Here the dynamic fields work fully, which is where Breakdance earns its keep.

  1. Create a Breakdance Archive template.
  2. Set the condition to the Offer taxonomy (dispense_offer).
  3. Build the header:
Element Dynamic data
Image AIQ Ecommerce Offers → Offer Banner
Heading AIQ Ecommerce Offers → Offer Name
Text AIQ Ecommerce Offers → Offer Type
Text AIQ Ecommerce Offers → Offer Description
  1. Add a Post Loop below to list the offer’s products — the archive query already has them.
A single offer page in Breakdance showing the banner, name, type and product grid.
A single offer page in Breakdance showing the banner, name, type and product grid.

Responsive art direction

If you have genuinely different crops per device, use the per-device fields with Breakdance’s breakpoint controls: Banner (Desktop) above 1024px, Banner (Tablet) 768–1024px, Banner (Mobile) below 768px. Otherwise use Offer Banner and let it resolve.

Brand pages

An Archive template on the Brand taxonomy. Use the AIQ Ecommerce Brands fields on the term page, or [dispense_brand_image] in a Shortcode element.

Performance notes

  • Keep loop page sizes to 12–24.
  • Prefer taxonomy queries to meta queries.
  • Turn on Breakdance’s CSS optimisation options under Breakdance → Settings → Performance.
  • Set explicit image sizes.
  • Pages using the live detail shortcodes cannot be page-cached.

Common problems

The AIQ Ecommerce groups are missing from dynamic data.

Check both plugins are active, then regenerate Breakdance’s CSS.

Offer banners are empty in my offers listing.

You built it with a Term Loop Builder. Use [dispense_offers].

Offer fields are empty on a normal page.

They need an offer context. On a page with no offer they resolve empty — that is expected.

The image element shows nothing.

Bind it to Product Image URL. Products have no featured image.

Sorting by price is wrong.

Order by Meta value (number), not Meta value.

Add to Cart does nothing in a loop.

Pass the ID: [dispense_add_to_cart product_id="{{acf:dispense_product_id}}"].

The ACF offer fields do not resolve in a term loop.

Same limitation as the native fields — Breakdance keeps the ACF context on the page, not the loop’s term. Use the shortcode.

My template does not apply to products.

Check the condition targets the AIQ Ecommerce Product post type, and that no more specific template is taking precedence.

Did this answer your question?