Troubleshooting & FAQ for Smart Add-Ons

Tip: Most storefront issues clear after confirming the group is assigned, the license is active, and page/object cache is flushed.

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.
Verify your license is active: Smart Add-Ons → License should show “Active”.
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, 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 requires the Pro plan or above. The menu item will not appear on Starter. Check Smart Add-Ons → License to confirm your plan name.

AI Suggestions not loading

AI suggestions require the Pro plan. Confirm plan on the License page.
The Dhyan Cloud SaaS backend requires an OPENAI_API_KEY environment variable to be set. Contact support if you manage your own backend instance.

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 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: Starter (1 site), Pro (3 sites), Agency and Enterprise (999 sites).

What happens if my license expires?

A 7-day local grace period (SDK) and 14-day backend grace period apply after expiry. During this time the plugin continues working. After both periods, advanced features are locked but the plugin continues to display already-saved addon data. Renew from app.dhyansoftware.com (opens in new tab).

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. WPML integration is available via the saue_translate_string filter. The plugin ships with 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 →