Setup
Where do I get my Client Key?
It arrives in your licence e-mail from Deeproots. It looks like CLT_ followed by 24 characters. If you cannot find it, contact support — do not guess.
Why does my domain have to be registered?
Your Client Key is tied to specific domains. Every request sends the key and the domain, and both are checked. It means a leaked key is useless to anyone on a different domain.
Can I use the plugin on staging as well as live?
Yes. Both domains need registering against your Client Key, and you do not need a second licence.
Tell support the staging domain and it is added.
I am moving my site to a new domain. What do I do?
Tell support the new domain before the move. Once it is registered, the site works the moment it switches over. If you move first, syncing stops until we add the domain — but your published products stay online throughout.
Do I need WooCommerce?
No. The plugin is entirely independent of WooCommerce, and does not require or conflict with it.
What are the minimum requirements?
WordPress 5.8 and a PHP version WordPress itself supports, with HTTPS and outbound HTTPS access to https://api-dispense.deeproots.io. WordPress 6.4 and PHP 8.1 or newer are recommended. See Introduction & Requirements.
Can I install it on a multisite network?
It works on individual sites in a network. Each site needs its own Client Key and its own registered domain, since licensing is per domain.
Products and syncing
How often do products update?
As often as you choose, from every five minutes to weekly. The default is every 30 minutes. Set it on the General tab.
Why is a product not appearing on my site?
Two rules decide this:
- The product must be enabled in AIQ Ecommerce.
- A new product must have a product URL on your hosted AIQ Ecommerce menu — the plugin will not create a new post without one.
Also check its venue is ticked on the Venues tab.
Can I edit product descriptions in WordPress?
You can, but they are overwritten on the next sync — half an hour later by default. Edit the description in AIQ Ecommerce instead, or add your own separate custom field and have your template prefer it. The plugin only touches its own dispense_* fields.
What happens to products that are discontinued?
They are deleted from your site at the end of the next successful sync. A failed sync deletes nothing.
Are product images stored on my site?
No. The image URL is stored and the picture is served from AIQ Ecommerce. That costs you no disk space and no sync time, but it does mean your template must output dispense_product_image_url — products have no WordPress featured image.
Can I upload my own brand logos?
Yes, on the brand term. A manual upload always wins and is never overwritten by a sync.
What happens if I untick a venue?
Every product imported from that venue is deleted from your site. Re-tick it and re-sync to bring them back, though any manual edits are gone.
Why did my sync only import some products?
Check the sync summary for an error, check every venue you expect is ticked, and check the products are enabled with menu URLs in AIQ Ecommerce. On very large catalogues a run can be cut short by time limits — the next run continues where it left off.
Can I sync more than one AIQ Ecommerce account?
Yes. The licensing service works out which account can serve each venue. On your side there is one Client Key and one list of venues.
Cart and checkout
Do customers have to leave my site to buy?
Not in Full storefront mode — the AIQ Ecommerce checkout is embedded in a page on your domain. In Sync only mode, they go to your hosted AIQ Ecommerce menu.
What is the difference between Full storefront and Sync only?
Full storefront runs the cart and checkout on your site. Sync only imports data for display and sends buyers to your hosted menu. See Choosing Your Plugin Mode.
Can I switch modes later?
Yes, and it is not destructive. Products, offers, settings and page designs are all unaffected.
Switching to Sync only ends any cart in progress, so do it outside trading hours.
Can I style the checkout?
No. It is an iframe served by AIQ Ecommerce, so your CSS does not reach inside it. You can style the page around it, and choose whether your theme’s header and footer appear.
How long does a customer’s cart last?
30 days by default. Developers can change it with the dispense_cart_session_lifetime filter.
Can a customer buy from two locations at once?
No. A cart belongs to one venue. Adding something from another location prompts them to reset and start again.
Does the plugin handle payments?
No. Payment happens entirely inside the AIQ Ecommerce checkout. The plugin never sees payment details.
Does the cart check stock?
AIQ Ecommerce re-checks price and availability when an item is added, so a customer cannot buy at a stale price. Your listing page can be behind; the transaction cannot. Display dispense_product_quantity if you want to show stock levels.
Display and design
Do I need a page builder?
No, but it helps. The plugin’s shortcodes produce working listings, product pages and offer grids with no builder at all. Elementor, Bricks and Breakdance are supported if you want full design control.
Why are my offer banners empty in a page builder loop?
Page builders hand a term loop only their own built-in fields, never the loop’s term to custom dynamic fields. Use [dispense_offers], which resolves every offer on the server. Single offer pages work fine with dynamic fields.
Where do I add custom CSS?
Either AIQ Ecommerce Products → API Settings → Tools & Debug → Custom CSS, or your child theme.
The Custom CSS box travels with the plugin settings and survives theme changes.
Can I change the product URL structure?
Yes — Localized (with the venue in the URL) or Universal (without). Decide before launch if you can; changing it later changes every product address and needs redirects.
How do I show products for one location only?
Filter your listing by the Venue taxonomy (dispense_venue_tax), or use [dispense_products venue_id="..."] with the ID from the Venues tab.
Can I use FacetWP?
Yes, and there is direct support for it. Set your facet names on the General tab and the plugin pre-selects the right facet on brand and category archives.
Licensing and billing
What does my licence cover?
Use of the plugin on the domains registered against your Client Key, and access to the AIQ Ecommerce API through the licensing service for the venues on your account. See Your Licence Explained.
What happens if my licence is withdrawn?
Syncing stops on the very next request. Products already published stay published and your storefront keeps working — prices and stock simply stop updating.
Who do I contact about invoices?
Deeproots. See Account Changes & Requests.
How do I add a new location to my licence?
Ask support. Once the venue is on your licence it appears on the Venues tab automatically — you do not need a new Client Key.
Can I move my licence to a different site?
Yes. Ask support to register the new domain. If the old site is being retired, ask for its domain to be removed at the same time.
Is my Client Key sensitive?
Yes. It is not a AIQ Ecommerce credential, but it is the only thing standing between a stranger and your catalogue. Treat it like a password: do not post it in public, and ask for a replacement if it is exposed.
Compatibility
Which page builders are supported?
Elementor (Pro, for dynamic tags), Bricks and Breakdance, each with native dynamic fields. ACF fields and REST API fields are also registered, so any tool that reads those works too.
Does it work with my theme?
It should. The plugin registers a post type and taxonomies and supplies shortcodes; your theme handles the layout. The only theme-specific issue we see regularly is a position: fixed sticky header overlapping the checkout frame, which the default minimal shell avoids.
Does it work with caching plugins?
Yes, with configuration. This matters more than people expect — see Caching & Site Speed.
Does it work with my SEO plugin?
Yes. Products are ordinary WordPress posts, so Yoast, Rank Math and others handle them normally. The plugin does not output product structured data itself; add it in your SEO plugin if you want rich results.
Does it work with a multilingual plugin?
Product content comes from AIQ Ecommerce in one language and is refreshed on every sync, so translating it in WordPress does not persist. Translate your own page content normally.
Will it conflict with WooCommerce?
No. They are independent. You can run both, though you would be maintaining two catalogues.
What PHP version do I need?
The plugin enforces no floor of its own, so whatever WordPress supports. Run 8.1 or newer — there is no reason to stay on an older version.
Still not answered?
- Troubleshooting Common Issues
- Error Messages Explained
- Getting Help