Tip: Most storefront issues clear after confirming the group is assigned and page/object cache is flushed. Storefront add-ons do not depend on your license status.

Common issues

Addon groups not showing on product page

Check that the addon group is assigned to this product (or to its category, or set as Global).
Check that the plugin is active (Plugins page shows “Active”, not “Inactive”).
Check the group’s Visibility settings — it may be restricted by user role or date schedule.
Check that any conditional logic on the group is not hiding it by default.
Clear any page/object cache and reload the product page.

Live price preview not updating

Open your browser’s developer tools and check the Console tab for JavaScript errors.
Check the Network tab — look for a request to /wp-json/saue/v1/price-preview and check the response.
If using a caching plugin, add /wp-json/saue/ to the excluded URLs list.

License activation failing

Confirm the key starts with ADDF- — if not, you may have a key for a different product.
Check that your server can make outbound HTTPS requests to app.dhyansoftware.com.
If you see ACTIVATION_LIMIT_REACHED, your plan’s production or non-production activations are all in use — deactivate an existing site from the customer portal first.
If you see DOMAIN_MISMATCH, the key was activated on a different domain. Deactivate from the portal and reactivate.

File upload failing

Check PHP limits: upload_max_filesize and post_max_size must be larger than the uploaded file. Increase in php.ini or via a plugin.
Check that the MIME type is in the field's allowed types list (Smart Add-Ons → Group → file field → Allowed file types).
Check that the WordPress uploads directory is writable (wp-content/uploads/).

Block checkout ignoring addon data

Ensure WooCommerce is version 8.0 or later (required for Store API support).
Deactivate and reactivate Smart Add-Ons to re-register the StoreApiExtension.
Check WooCommerce → Status → Tools → "Clear WooCommerce blocks cache".

A/B Test Manager not visible

A/B testing is a Pro feature. On Starter, the A/B Tests screen shows an upgrade notice instead of the builder. On Pro, creating or editing A/B tests also needs an active license — check Smart Add-Ons → License to confirm your plan and license status.

AI Suggestions not loading

AI suggestions are a Pro feature and require an active license. Confirm your plan and license status on Smart Add-Ons → License.
AI suggestions run through Dhyan Cloud, so your site must be able to reach it. If they still do not load, contact support.

Frequently asked questions

Does Smart Add-Ons work with WooCommerce block themes?

Yes — fully compatible. Smart Add-Ons uses StoreApiExtension and StoreApiCartBridge to integrate with the WooCommerce Store API natively. Both classic and block-based (FSE) themes are supported.

Does it work with HPOS (High-Performance Order Storage)?

Yes — HPOS compatibility is explicitly declared via WooCommerce’s FeaturesUtil. The plugin uses the WooCommerce order API, not legacy post meta.

How many addon groups can I create?

There is no hard limit on the number of addon groups or fields you can create. Performance depends on your server and the number of fields rendered per product page.

Can I add add-ons to all products globally?

Yes — when creating or editing an addon group, set the assignment to Global (all products). The group will appear on every product. You can exclude individual products from a global group from the product edit screen.

Do add-ons work with WooCommerce Subscriptions?

Yes — Smart Add-Ons works with WooCommerce Subscriptions. Use the saue_subscriptions_addon_groups filter to control which groups appear on subscription products. See the Hooks & Filters reference.

Does it work with WooCommerce Bookings?

Addon groups render on a bookable product the same way they render on a simple product. There is no booking-date, resource, or person-aware pricing. When WooCommerce Bookings is active, saue_bookings_before_product_addons fires for any product with addons so you can add your own booking-specific logic. See the WooCommerce Bookings guide.

Does the file upload store files publicly?

No. Uploaded files are stored in a private directory inside wp-content/uploads/saue-uploads/ with an .htaccess rule blocking direct access. Admins download them via a signed endpoint from the WooCommerce order page.

How many sites can I activate the plugin on?

Activation limits depend on your plan and on the type of site. Starter includes 1 production site and 3 non-production sites; Pro includes 3 production sites and 3 non-production sites.

What happens if my license expires?

Smart Add-Ons is not remotely disabled when a license expires: your existing add-on groups, fields, and settings keep running on your storefront. An expired license affects access to updates, support, applicable AI/cloud services, and Pro authoring — you cannot add or change Pro-only content (such as new formula pricing or A/B tests) until you renew. Renew from app.dhyansoftware.com (opens in new tab).

What happens if my license is revoked?

A revoked license does not disable Smart Add-Ons on your site — your existing configuration keeps running on your storefront. Pro authoring, updates, and support are unavailable until the license is reactivated. You can check your license status under Smart Add-Ons → License.

What does the “Unverified” license status mean?

Unverified means Smart Add-Ons could not confirm your license with the licensing service recently — for example because WP-Cron is not running or the service could not be reached. Smart Add-Ons keeps using your last known license information and your storefront is not affected. Until the license is confirmed again, Pro authoring and AI/cloud features may be unavailable. If the status persists, check that WP-Cron is running or reactivate your license.

What counts as a production or non-production site?

A non-production site is a local, staging, development, test, demo, sandbox, or preview environment, recognized from the site address (for example localhost, a .local or .test address, or a staging. or dev. subdomain). Any other site address counts as production.

Do I need a license for every staging site?

Staging and other non-production sites use your plan’s non-production activations — 3 on both Starter and Pro — and do not use a production activation.

Does Smart Add-Ons contact the licensing server when shoppers visit my store?

No. Shopper page views, add-on selection, cart, checkout, and file uploads are handled on your own site and do not depend on the licensing service. License status is verified periodically in the background, not on shopper requests. AI features connect to Dhyan Cloud when you use them.

Are updates and support included?

Yes, with an active license: plugin updates, email support (priority support on Pro), and applicable AI/cloud services. Update downloads require an active license. If your license has expired, you can still contact us about billing and renewal; product support requires an active license.

Can I build custom field types?

Yes — implement SmartAddOnsContractsFieldTypeInterface and register via the saue_register_field_types action hook. See the Hooks reference.

Is the plugin translation-ready?

Yes — the text domain is saue. When WPML is active, addon labels are passed through saue_translate_string (the plugin already attaches WPML’s wpml_translate_single_string filter). Those dynamic strings are not registered with WPML String Translation automatically, so they will not translate until you register them. See the WPML guide. Plugin UI strings ship in a .pot file in /languages/.

Still need help?

Email support@dhyansoftware.com with your license key, site URL, WordPress/PHP/WooCommerce versions, and steps to reproduce. You can also open a ticket directly from app.dhyansoftware.com (opens in new tab).

← Smart Add-Ons docs

Open support →

Troubleshooting & FAQ