FAQ

Installation

Does the plugin work without WooCommerce? No. WooCommerce is required.

Why is nothing on the storefront after install? Enable AI Agent defaults to off. Turn it on under Settings → General.

Is a license key required? This build has no license-key screen. Feature gates default to allowed unless another plugin filters them.

AI configuration

Do I need an API key? No for catalog search, cards, cart, and WooCommerce-based recommendations. Yes for conversational answers, AI intent, AI recovery copy.

Which providers are supported? OpenAI and Gemini adapters. Anthropic/OpenRouter hosts are allow-listed for URLs only.

Where is the key stored? Encrypted option aiwsa_credentials, or a wp-config.php constant. Never in frontend JS.

Product search

Is this semantic AI search? Native WooCommerce search plus optional AI intent JSON. Vector/hybrid search only if a developer hooks filters. No built-in embeddings.

Will it find exact product titles? Yes, including many simple products missing type/stock meta.

WooCommerce

Does it replace the shop loop? No. It is a chat assistant plus tools.

HPOS? Declared compatible; order APIs use WooCommerce CRUD.

Languages

Which languages? Auto Detect plus en, es, fr, de, it, pt, ar, bn, hi, zh, ja.

Does this translate wp-admin? No. Admin uses the WordPress text domain.

Upsell / cross-sell

Does AI invent products? No. Live catalog + WooCommerce linked products.

Cart / checkout / orders

Is checkout inside the chat? No. The button goes to WooCommerce checkout.

Can guests see any order? Only after order number + billing email verification, if that tool is on.

Fallback

Does the plugin work offline? No. It works without an LLM. WordPress and WooCommerce must be reachable.

Privacy

What is stored? Conversations, tool calls, usage, optional analytics, optional abandoned carts, encrypted keys. See Privacy & security.

Is there a WP privacy exporter? No register_exporter in this version. Uninstall data deletion is opt-in.

Performance

Will every page load call OpenAI? No. Provider calls happen on chat turns (and optional intent/recommendation/recovery). Recommendations REST runs when the widget opens, not on every page view.

Compatibility

Elementor widget? No. Use the shortcode.

Gutenberg block? No.

PHP 8.0? No. PHP 8.1+ is required.