Deeproots Help Documentation Help Center

Products, Brands & Categories

Exactly what is imported for each product, how brands and categories work, cannabis types, terpenes and potency data, and what happens if you edit product content by hand.

Updated October 1, 2026

What information is imported for each product

Each product becomes a WordPress post of type dispense_product.

Standard post fields

WordPress field From AIQ Ecommerce
Post title Product name
Post content Product description
Post status Published (products in AIQ Ecommerce are only imported when enabled)

Custom fields

These are what your templates and page builders read.

Field Key Contains
Product ID dispense_product_id The product's unique ID in AIQ Ecommerce
Price dispense_product_price Standard price, formatted to two decimal places
Sale Price dispense_product_sale_price Discounted price, when the product is on a percentage sale or has a sale price set
Quantity dispense_product_quantity Stock quantity available
Image URL dispense_product_image_url The product image, served from AIQ Ecommerce
Menu Link dispense_product_menu_link The product's page on your hosted AIQ Ecommerce menu
Offer Details dispense_product_offer Comma-separated names of the offers applied to it

Two of these deserve a note:

  • Menu Link is what makes Sync only mode work. It is the address of this product on your hosted AIQ Ecommerce menu, and it is what your product cards should link to when the cart is not running on your site.
  • Sale Price is filled in when AIQ Ecommerce sends a sale price directly, and also calculated when a percentage SALE discount applies to the product. A product on a percentage sale also gets added to a category called Sale, which makes a “what’s on offer” listing very easy to build.
A single product edit screen with the Product Details meta box open, showing Product ID, Price, Quantity and Menu Link filled in.
A single product edit screen with the Product Details meta box open, showing Product ID, Price, Quantity and Menu Link filled in.

Taxonomies

Taxonomy Key URL
Brand dispense_brand /brand/{slug}/
Category dispense_category /categories/{slug}/
Offer dispense_offer /offers/{slug}/ (base configurable)
Terpenes dispense_terpenes /terpenes/{slug}/
Cannabis Type dispense_cannabis_type /cannabis_type/{slug}/
Venue dispense_venue_tax /dispense-venue/{slug}/

Each of these has a public archive, so /brand/northern-lights-co/ lists that brand’s products without you building anything.

Brands

Brands are created automatically from the product data. You will find them at AIQ Ecommerce Products → Brands.

Brand logos

The brand logo comes from AIQ Ecommerce and is stored on the brand term. You can also upload your own on the brand’s edit screen, which is useful when the supplied logo is low resolution or the wrong shape for your design.

A manual upload always wins. Once you have uploaded an image, later syncs will not overwrite it — the AIQ Ecommerce logo is kept separately in the background, but your choice is what displays.

A brand term edit screen with the Brand Image field, showing an uploaded logo and the Select / Remove image buttons.
A brand term edit screen with the Brand Image field, showing an uploaded logo and the Select / Remove image buttons.
The Brands list screen showing the Image column with brand logo thumbnails and product counts.
The Brands list screen showing the Image column with brand logo thumbnails and product counts.

Using brand data on the front end

Where How
Shortcode, image tag [dispense_brand_image]
Shortcode, URL only [dispense_brand_image_url]
Bricks / Breakdance dispense_brand_image_url, dispense_brand_name

Both shortcodes work out which brand you mean automatically — on a brand archive, inside a term loop, or from the brand assigned to the product being displayed. Pass term_id="123" to target a specific brand instead.

Brand pages

/brand/{slug}/ works out of the box. To design it, build a taxonomy archive template for dispense_brand in your page builder. If you use FacetWP, the brand facet can be pre-selected automatically on these pages — see Product Filtering & Search.

Categories

Categories come from AIQ Ecommerce’s product categories — Flower, Edibles, Concentrates, Pre-Rolls and so on. Find them at AIQ Ecommerce Products → Categories.

They behave like ordinary WordPress taxonomy terms, so you can:

  • Reorder or rename them for display (see the warning about renaming below)
  • Add descriptions that show on category pages
  • Nest them, if your structure calls for it

Category archives live at /categories/{slug}/, or /{base-slug}/{venue}/categories/{slug}/ when you use Localized URLs. The number of products per page comes from Products Per Page on the General tab, which defaults to 8.

The Categories list screen with imported categories and their product counts.
The Categories list screen with imported categories and their product counts.

The “Sale” category

The plugin creates a category called Sale and adds any product with a sale price to it. Building a sale listing is then just a category archive or a query loop on that term.

Cannabis types and strains

Cannabis type — Indica, Sativa, Hybrid and so on — is imported into the Cannabis Type taxonomy (dispense_cannabis_type), with an archive at /cannabis_type/{slug}/.

Show it on a product page with:

Shortcode
[dispense_product_cannabis_type]

This shortcode fetches the value from AIQ Ecommerce for the product being displayed, so it is accurate even for detail that is not stored on the post.

Terpenes and potency information

Terpene results come from the product’s lab data. Each terpene present is created as a term in the Terpenes taxonomy, with readable names rather than raw data keys:

Data key Term created
alphaPinene Alpha Pinene
betaCaryophyllene Beta Caryophyllene
betaMyrcene Beta Myrcene
betaPinene Beta Pinene
bisabolol Bisabolol
caryophylleneOxide Caryophyllene Oxide
guaiol Guaiol
humulene Humulene
limonene Limonene
linalool Linalool
ocimene Ocimene
terpinene Terpinene
terpinolene Terpinolene
threeCarene Three Carene
transNerolidol Trans Nerolidol
betaEudesmol Beta Eudesmol

Terpene terms are replaced wholesale on each sync, so a product’s terpene list always matches its current lab data rather than accumulating old results.

Showing potency and lab data

Four shortcodes fetch detailed product data live from AIQ Ecommerce for the product being displayed:

Shortcode Shows
[dispense_product_cannabinoids] Cannabinoid figures — THC, CBD and so on
[dispense_product_terpenes] The terpene list
[dispense_product_terpenes_type] The dominant terpene type
[dispense_product_effects] Reported effects

These call the API when the page renders rather than reading stored fields, so they show the most current lab data — but they also make the page slower and are why product pages must never be served from a page cache. See Caching & Site Speed.

A front-end single product page showing cannabinoid figures, a terpene list and effects rendered by the detail shortcodes.
A front-end single product page showing cannabinoid figures, a terpene list and effects rendered by the detail shortcodes.

Editing product content, and what gets overwritten on the next sync

This is the part most worth understanding before you invest time in editing.

Overwritten on every sync

What Why
Product title Re-read from the product name
Product description (post content) Re-read from AIQ Ecommerce
Price, sale price, quantity Re-read
Image URL Re-read
Menu link Re-read
Offers, brand, category, cannabis type, terpenes Re-assigned from current data

Anything you type into these will be replaced. If you rewrite a product description in WordPress, it lasts until the next sync — half an hour, by default.

Kept

What Why
Manually uploaded brand logos The sync deliberately never overwrites a manual upload
Custom fields you add yourself The plugin only touches its own dispense_* fields
Category and brand term descriptions Descriptions are yours; only term assignment is managed
Your templates and page designs Entirely separate from the data

If you want custom product copy

Do not edit the imported description — it will not survive. Instead:

  1. Change it in AIQ Ecommerce. Best option: the description is right everywhere, including your hosted menu.
  2. Add your own custom field (with ACF or similar) alongside the imported ones, and have your template prefer yours when it is filled in. The plugin will not touch a field it does not own.

If a product is deleted and comes back

Deletion is permanent — the post is removed, not trashed. If the product returns in AIQ Ecommerce the next sync recreates it as a new post, so any manual work attached to the old one is gone. That is another reason to keep custom content in AIQ Ecommerce or in your own fields.

Common problems

I edited a product description and it reverted.

Expected. Imported content is replaced on every sync. Edit it in AIQ Ecommerce instead.

The brand logo I uploaded disappeared.

Manual uploads are preserved, so check the upload actually saved on the brand term, and that you uploaded it on the brand rather than on a product.

A category I renamed came back under its old name.

Categories are matched by name during the sync. Rename the display in your template, not the term.

Terpenes show on some products and not others.

Terpene terms only exist where AIQ Ecommerce has lab data for that product. No lab data, no terms.

The detail shortcodes show nothing.

They fetch from AIQ Ecommerce at page-render time, so they need a working connection and a product with that data. Check Test Connection on the Tools & Debug tab, and check the page is not being served from a cache.

Did this answer your question?