Deeproots Help Documentation Help Center

Page Builder: Elementor

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

Updated October 1, 2026

You will need: Elementor Pro. The free version has no dynamic tags and no theme builder, which are exactly the two features this relies on.

Setting up

There is nothing to install or switch on. When Elementor is active, the plugin registers its dynamic tags automatically.

To confirm:

  1. Edit any page with Elementor.
  2. Add a Heading widget.
  3. Click the dynamic tag icon (the small database symbol) beside the Title field.
  4. Look for a AIQ Ecommerce Products group in the list.
The Elementor dynamic tag picker open, with the Dispense Products group expanded showing its tags.
The Elementor dynamic tag picker open, with the AIQ Ecommerce Products group expanded showing its tags.

If the group is missing: check Elementor Pro is active, check the AIQ Ecommerce plugin is active, and clear Elementor’s cache at Elementor → Tools → Regenerate CSS & Data.

Available dynamic fields

Product tags

Available on single product templates and inside a loop over dispense_product.

Tag Field key Type
Price dispense_product_price Text
Quantity dispense_product_quantity Text
Menu Link dispense_product_menu_link URL
Offer Details dispense_product_offer Text
Product Sale Price dispense_product_sale_price Text

Offer tags

Tag Field key Type
Offer Name dispense_offer_name Text
Offer Type dispense_offer_type Text
Offer Image dispense_offer_image Image

These resolve the offer for the current context: the offer archive, a term loop over dispense_offer, or the product’s first assigned offer.

Everything else

Fields not in the list above — the product image URL, the product ID — are still readable through Elementor’s own ACF Field or Post Custom Field dynamic tags, using the field key:

To show Use
Product image ACF Field / Post Custom Field → dispense_product_image_url
Product ID ACF Field / Post Custom Field → dispense_product_id
An Elementor Image widget with its source set to a dynamic ACF field pointing at dispense_product_image_url.
An Elementor Image widget with its source set to a dynamic ACF field pointing at dispense_product_image_url.

Building a product listing

With Loop Grid (Elementor Pro 3.8+)

The best option — you design one card and it repeats.

  1. Add a Loop Grid widget.
  2. Under Query, set Source to AIQ Ecommerce Product.
  3. Click Edit Template to design the card.
  4. Build the card:
Element Content
Image Dynamic → ACF Field → dispense_product_image_url
Heading Dynamic → Post Title
Text Dynamic → AIQ Ecommerce Products → Price
Text Dynamic → AIQ Ecommerce Products → Offer Details
Button Link → Dynamic → Post URL (Full storefront) or AIQ Ecommerce Products → Menu Link (Sync only)
  1. Save the template and return to the page.
  2. Set columns, rows and pagination on the Loop Grid.
The Elementor Loop Grid query panel with Source set to AIQ Ecommerce Product.
The Elementor Loop Grid query panel with Source set to AIQ Ecommerce Product.
A loop item template in the Elementor editor showing the product card layout with dynamic fields bound.
A loop item template in the Elementor editor showing the product card layout with dynamic fields bound.

Filtering the loop

Under Query → Term, add a taxonomy filter:

To show Filter on
One category Category (dispense_category)
One brand Brand (dispense_brand)
One location Venue (dispense_venue_tax)
One offer Offer (dispense_offer)
Products on sale Category → Sale

On a multi-location site with Universal URLs, filtering by venue is what stops the same product appearing twice.

With the shortcode instead

If you do not have Loop Grid, or you want the plugin’s built-in filters:

  1. Add a Shortcode widget.
  2. Enter [custom_product_filter show_filters="true"].

You get the listing and its filters, styled by CSS rather than in Elementor. See Styling & Branding.

Building a single product page

  1. Go to Templates → Theme Builder → Single Post.
  2. Click Add New and choose Single Post.
  3. Set the display condition to AIQ Ecommerce Products.
The Elementor display conditions dialog with the condition set to the AIQ Ecommerce Products post type.
The Elementor display conditions dialog with the condition set to the AIQ Ecommerce Products post type.

A workable layout

Left column — the image

Image widget → Dynamic → ACF Field → dispense_product_image_url Right column — the details

Element Content
Heading Dynamic → Post Title
Text Dynamic → AIQ Ecommerce Products → Price
Text Dynamic → AIQ Ecommerce Products → Product Sale Price (set a conditional so it only shows when filled)
Text Dynamic → AIQ Ecommerce Products → Offer Details
Text Dynamic → AIQ Ecommerce Products → Quantity
Shortcode [dispense_product_cannabis_type]
Shortcode [dispense_product_quantity_buttons]
Shortcode [dispense_add_to_cart]

Below — the detail tabs

Use a Tabs widget with a Shortcode widget in each pane:

Tab Shortcode
Description Dynamic → Post Content
Cannabinoids [dispense_product_cannabinoids]
Terpenes [dispense_product_terpenes]
Effects [dispense_product_effects]
A finished single product page in Elementor: image on the left, title, price and add-to-cart on the right, detail tabs below.
A finished single product page in Elementor: image on the left, title, price and add-to-cart on the right, detail tabs below.

In Sync only mode

Replace the add-to-cart shortcode with a Button whose link is Dynamic → AIQ Ecommerce Products → Menu Link, labelled something like “Buy on our menu”. The cart shortcodes render nothing for visitors in that mode.

Building offer layouts

An all-offers page

Use the shortcode, not a loop:

  1. Create a page.
  2. Add a Shortcode widget.
  3. Enter [dispense_offers columns="3" hide_empty="1"].

Then set AIQ Ecommerce Products → API Settings → General → Offers Index Page to that page’s slug and flush permalinks. See Offers & Promotions.

A single offer page

Here the dynamic tags work properly.

  1. Go to Templates → Theme Builder → Archive.
  2. Add a new Archive template.
  3. Set the condition to the Offer taxonomy.
  4. Build the header:
Element Content
Image Dynamic → AIQ Ecommerce Products → Offer Image
Heading Dynamic → AIQ Ecommerce Products → Offer Name
Text Dynamic → AIQ Ecommerce Products → Offer Type
Shortcode [dispense_offer_description]
  1. Add an Archive Posts widget below it. It picks up the offer’s products automatically.
A single offer page in Elementor showing the banner, offer name, type badge and the product grid below.
A single offer page in Elementor showing the banner, offer name, type badge and the product grid below.

An offer banner elsewhere

On a product page, a Shortcode widget containing [dispense_offer_banner] shows the banner for the product’s first offer. For a specific offer anywhere:

Shortcode
[dispense_offer_banner term_id="17"]

Performance notes

Elementor is heavy, and product listings are the place it shows. On large catalogues:

  • Keep Loop Grid page sizes modest — 12 to 24 items.
  • Keep the loop item template simple. Every widget multiplies by the number of products.
  • Enable Elementor’s Improved Asset Loading and Inline Font Icons under Elementor → Settings → Features.
  • Prefer the plugin’s shortcode listing over a complex Loop Grid on very large menus.
  • Remember that any page using the live detail shortcodes cannot be cached — see Caching & Site Speed.

Common problems

The AIQ Ecommerce Products group is missing from the dynamic tag picker.

Elementor Pro is required. Confirm it is active, then regenerate Elementor’s CSS and data.

A dynamic tag shows nothing.

It has no context. Product tags need a product; offer tags need an offer. On a plain page there is neither, so they resolve empty. Preview inside a template with a real product assigned.

Offer tags are empty in a Loop Grid over offers.

Expected — term loops do not pass their term to custom dynamic tags. Use [dispense_offers].

The product image is missing.

Products have no featured image; the image is a URL in dispense_product_image_url. Bind the Image widget to that field.

Add to Cart does nothing in a loop.

Inside a loop the shortcode needs the product ID: [dispense_add_to_cart product_id="{{acf:dispense_product_id}}"].

My template shows on the wrong post type.

Check the display conditions are set to AIQ Ecommerce Products and not to all singular posts.

Prices are stale on the front end.

Elementor caches rendered CSS and, with some setups, markup. Combine that with a page cache and you can be several syncs behind. Exclude product pages from full-page caching.

Did this answer your question?