Security update. Storefront pages now use a public key that cannot change your account, and URL filters are limited to your configured fields. After updating, deactivate and reactivate AskAgento once to issue the public key; the storefront chatbot and image search stay off until you do.<\/p>","1.2.3":"
Cosmetic only. Titles the legacy compatibility block so it reads correctly in the plugin directory's block list, and makes the readme's service links clickable.<\/p>","1.2.2":"
Documentation only, no functional changes. Updates the plugin listing title and adds live demo, website and API documentation links to the description.<\/p>","1.2.1":"
Documentation only, no functional changes. Corrects the Installation steps and adds instructions for activating a Basic or Pro plan bought on askagento.com, including the manual sync needed afterwards.<\/p>","1.2.0":"
Adds a "Manage subscription" button for changing plan or cancelling, fixes add-on pack credits being wiped by a plan change or the monthly reset, and shows the remaining pack balance in Settings \u2192 Status. Update if you have ever bought a search or AI token pack.<\/p>","1.1.3":"
Installation now confirms your shop is publicly reachable before sending your catalogue, so an unreachable shop fails immediately with a clear reason instead of part-way through setup.<\/p>","1.1.2":"
Internal rename of the search field sent to the service; no functional changes.<\/p>","1.1.1":"
Clarifies that installation requires a publicly reachable shop; no functional changes.<\/p>","1.0.7":"
Plugin header metadata fix; no functional changes.<\/p>","1.0.6":"
The storefront chatbot credit is now optional and hidden by default; re-enable it under AI Chatbot \u2192 Setup if you want it shown.<\/p>","1.0.5":"
Documentation refresh; no functional changes.<\/p>","1.0.4":"
Security hardening, WordPress coding-standards compliance, and admin consent notice improvements.<\/p>","1.0.3":"
Improved recommendations and added German, French, Spanish, and Italian interface translations.<\/p>","1.0.0":"
Initial public release.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":2},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3682529,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3682529,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256},"icon.svg":{"filename":"icon.svg","revision":3682529,"resolution":false,"location":"assets","locale":false}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3682529,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3682529,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"askagento\/filter":{"name":"askagento\/filter","title":"AskAgento Product Filter"},"product-filter\/filter":{"name":"product-filter\/filter","title":"AskAgento Product Filter (legacy)"}},"tagged_versions":["1.2.1","1.2.2","1.2.3","1.2.4"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3682529,"resolution":"1","location":"assets","locale":"","width":1536,"height":1024},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3682529,"resolution":"2","location":"assets","locale":"","width":1200,"height":800},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3682529,"resolution":"3","location":"assets","locale":"","width":1536,"height":1024},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3682529,"resolution":"4","location":"assets","locale":"","width":1536,"height":1024},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3682529,"resolution":"5","location":"assets","locale":"","width":1536,"height":1024},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3682529,"resolution":"6","location":"assets","locale":"","width":1536,"height":1024},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3682529,"resolution":"7","location":"assets","locale":"","width":1536,"height":1024},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3682529,"resolution":"8","location":"assets","locale":"","width":1536,"height":1024}},"screenshots":{"1":"Setup \u2014 install the plugin and finish WooCommerce onboarding","2":"Unified data layer \u2014 one catalogue powering search, chat, and recommendations","3":"AI Search \u2014 natural-language and image product search","4":"AI Recommend \u2014 automatic upsell and cross-sell recommendations","5":"AI Chatbot \u2014 product-aware storefront assistant","6":"AI Agents \u2014 connect your catalogue to Cursor, Claude, and OpenAI via MCP","7":"Auto Filter \u2014 auto-generated product filters","8":"Auto Label \u2014 auto-generated product attributes, categories, and tags","9":"Usage \u2014 service allowance and remaining usage in wp-admin"}},"plugin_section":[],"plugin_tags":[2353,2364,6033,944,286],"plugin_category":[45],"plugin_contributors":[279293],"plugin_business_model":[],"class_list":["post-342385","plugin","type-plugin","status-publish","hentry","plugin_tags-ai","plugin_tags-chatbot","plugin_tags-product-filter","plugin_tags-search","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-visualsearch","plugin_committers-visualsearch"],"banners":{"banner":"https:\/\/ps.w.org\/askagento\/assets\/banner-772x250.png?rev=3682529","banner_2x":"https:\/\/ps.w.org\/askagento\/assets\/banner-1544x500.png?rev=3682529","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":"https:\/\/ps.w.org\/askagento\/assets\/icon.svg?rev=3682529","icon":"https:\/\/ps.w.org\/askagento\/assets\/icon.svg?rev=3682529","icon_2x":false,"generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/askagento\/assets\/screenshot-1.png?rev=3682529","caption":"Setup \u2014 install the plugin and finish WooCommerce onboarding"},{"src":"https:\/\/ps.w.org\/askagento\/assets\/screenshot-2.png?rev=3682529","caption":"Unified data layer \u2014 one catalogue powering search, chat, and recommendations"},{"src":"https:\/\/ps.w.org\/askagento\/assets\/screenshot-3.png?rev=3682529","caption":"AI Search \u2014 natural-language and image product search"},{"src":"https:\/\/ps.w.org\/askagento\/assets\/screenshot-4.png?rev=3682529","caption":"AI Recommend \u2014 automatic upsell and cross-sell recommendations"},{"src":"https:\/\/ps.w.org\/askagento\/assets\/screenshot-5.png?rev=3682529","caption":"AI Chatbot \u2014 product-aware storefront assistant"},{"src":"https:\/\/ps.w.org\/askagento\/assets\/screenshot-6.png?rev=3682529","caption":"AI Agents \u2014 connect your catalogue to Cursor, Claude, and OpenAI via MCP"},{"src":"https:\/\/ps.w.org\/askagento\/assets\/screenshot-7.png?rev=3682529","caption":"Auto Filter \u2014 auto-generated product filters"},{"src":"https:\/\/ps.w.org\/askagento\/assets\/screenshot-8.png?rev=3682529","caption":"Auto Label \u2014 auto-generated product attributes, categories, and tags"}],"raw_content":"\n
AskAgento<\/strong> connects your WooCommerce store to a unified shopping data layer. Your catalogue is synced once; search, filters, labelling, recommendations, chat, and agent tools all use the same understanding of what you sell.<\/p>\n\n Live demo<\/a> · Webpage<\/a> · API<\/a><\/p>\n\n This plugin is not trialware and contains no locked features.<\/strong> Every screen, setting and\nfeature ships enabled for everyone. There is no licence key, no trial period, and no code\npath that disables functionality based on a subscription.<\/p>\n\n The AI features are performed by the AskAgento cloud service (see External services<\/strong>\nbelow). Like any hosted service, it has capacity limits. Those limits live entirely on the\nserver and determine how much catalogue the service processes for your shop<\/strong>, not which\nplugin features you may use:<\/p>\n\n Every plan, including Free, runs the complete feature set: AI text search, AI image search,\nchatbot, upsell and cross-sell recommendations, auto product filters, auto labels, and MCP\nagents. If your catalogue grows past what your current plan indexes, the plugin keeps\nworking and shows an informational notice; see pricing<\/a>.<\/p>\n\n Free is free forever<\/strong> \u2014 no credit card, no trial, no expiry date, and not one feature\nlocked or limited. Install the plugin and accept the consent notice on the Plugins screen\nto connect your site; you are on the Free plan from that moment, with nothing to buy,\nactivate or upgrade.<\/p>\n\n Paid plans are optional and bought on askagento.com. They raise only how much catalogue the\nservice indexes and how much AI usage is included each month. If you already paid there,\nlink the subscription to this site under AskAgento \u2192 Settings \u2192 Status<\/strong> using the claim\ncode shown on the page you reached after paying.<\/p>\n\n API Documentation: askagento.com\/api\/<\/a>\nTutorial videos: askagento.com\/tutorial.html<\/a>\nDemo shop: demowp.askagento.com<\/a>\nTerms of use: askagento.com\/terms.html<\/a>\nPrivacy policy: askagento.com\/privacy.html<\/a>\nLegal notice: askagento.com\/imprint.html<\/a><\/p>\n\n This plugin connects to AskAgento<\/strong> cloud services operated by VisualSearch GmbH to register your site, sync your WooCommerce catalogue, and run AI-powered search, filters, labelling, recommendations, chatbot, and MCP features.<\/p>\n\n Service:<\/strong> AskAgento API\nWebsite:<\/strong> askagento.com<\/a>\nAPI endpoint:<\/strong> api.askagento.com<\/a>\nAPI documentation:<\/strong> askagento.com\/api\/<\/a>\nTutorial videos:<\/strong> askagento.com\/tutorial.html<\/a>\nTerms of use:<\/strong> askagento.com\/terms.html<\/a>\nPrivacy policy:<\/strong> askagento.com\/privacy.html<\/a>\nLegal notice:<\/strong> askagento.com\/imprint.html<\/a><\/p>\n\n What is sent and when<\/strong><\/p>\n\n Consent and account requirement<\/strong><\/p>\n\n Features that call external services need a completed installation and an AskAgento account. A free account is available without a credit card and includes every feature. Catalogue sync starts only after the site administrator completes onboarding\/consent in the WordPress admin.<\/p>\n\n Site keys: public and secret<\/strong><\/p>\n\n Registering your site issues two keys. The secret key<\/strong> stays in your WordPress database and is only ever sent from your server to AskAgento. It controls catalogue sync, uninstall, AI provider keys, labels, filters, plan, usage and billing for your site, so it is never printed into a page.<\/p>\n\n The public key<\/strong> (it starts with Optional BYOK (bring your own LLM key) \u2014 third party AI providers<\/strong><\/p>\n\n BYOK is optional and off by default. If you choose to add your own API key under AskAgento \u2192 Settings \u2192 LLM Setup<\/strong>, two things happen.<\/p>\n\n Key test (from your server to the provider):<\/strong> when a site administrator clicks \"Test\", the plugin sends only the key you entered to the provider's read-only models endpoint, as an authorization header or query parameter, to check that it works. No product, catalogue, customer or site data is sent in this request.<\/p>\n\n Hosted AI (from AskAgento to the provider):<\/strong> when you save a key for a provider AskAgento can run on (OpenAI or OpenRouter), the plugin sends the key once over HTTPS from your server to AskAgento, which stores it with your site's registration. From then on AskAgento's servers use your key to call that provider for your site's AI requests, such as chatbot conversations and auto labels. Those requests carry the shopper's message and the product details needed to answer it. Your plan's AI token allowance is not charged for them, and the provider bills you directly. Clearing the key, or uninstalling the plugin, removes it from AskAgento as well.<\/p>\n\n In your WordPress database, provider keys are shown only in masked form in wp-admin and are removed when you clear them or uninstall the plugin. There are no requests to these providers from your storefront or visitors' browsers.<\/p>\n\n Each provider is an independent third party service; its own terms and privacy policy apply to the requests described above and to any use you make of that provider's API with your key.<\/p>\n\n Your shop must be publicly reachable.<\/strong> During setup our servers fetch your product pages and images, so installation from a password-protected, local (localhost \/ staging), or otherwise hidden shop will fail. This is checked before your catalogue is uploaded, and installation stops with the reason if the shop cannot be reached. Your catalogue also needs at least one product image, because products are indexed by their images.<\/p>\n\n Yes. AskAgento is built for WooCommerce product catalogues.<\/p><\/dd>\n Yes. The plugin uses AskAgento cloud services to sync your catalogue and provide AI-powered search, filters, labelling, recommendations, chatbot, and MCP features. You can start with the free plan, which includes every feature.<\/p><\/dd>\n Yes, and it includes every feature: AI text search, AI image search, chatbot, upsell and cross-sell recommendations, auto product filters, auto labels, and MCP agents. The free plan indexes catalogues up to 100 products and includes a monthly AI usage allowance. Paid plans index larger catalogues (Basic 2,000 products, Pro 5,000) with higher allowances; they do not add features. See pricing<\/a>.<\/p><\/dd>\n Go to AskAgento \u2192 Settings \u2192 Status<\/strong>, find Connect a purchase made on askagento.com<\/strong>, paste your claim code, and click Link purchase<\/strong>. The claim code starts with Finish installation first. The field appears only once your site is registered, because the subscription is attached to this site's registration. Linking changes your hosted service allowance only: the plugin is byte-for-byte the same on every plan, so there is nothing to re-install or update.<\/p>\n\n Add-on search and AI token packs bought on askagento.com are claimed the same way, each with the claim code from its own checkout.<\/p><\/dd>\nWhy AskAgento<\/h4>\n\n
\n
Features<\/h4>\n\n
\n
Service plans<\/h4>\n\n
\n
External services<\/h3>\n\n
\n
pk_<\/code>) is what your storefront uses. On pages with the chatbot or image search, the plugin puts your site ID and public key into the page (window.askagentoAiChatbotFront<\/code> and the image search block's data-api-key<\/code> attribute) so visitors' browsers can call AskAgento chat and search directly. Anyone who views the page source can read these values. The public key only allows chat, search and MCP requests against your catalogue. It cannot change or delete your data, read your account, or open billing. You also put the public key into AI agent configs (AskAgento \u2192 AI Agents<\/strong>). Chat and search requests made with it count toward your plan's usage allowance, like requests from your storefront.<\/p>\n\n\n
\n
cs_<\/code>), and click Link purchase<\/strong>. Then run a sync from AskAgento \u2192 Settings \u2192 Sync Data<\/strong>, because step 3 indexed only as many products as your previous plan allowed.<\/li>\n\n
\n
Do I need WooCommerce?<\/h3><\/dt>\n
Do I need an AskAgento account?<\/h3><\/dt>\n
Does the plugin work without a paid subscription?<\/h3><\/dt>\n
I bought Basic or Pro on askagento.com. How do I activate it on my site?<\/h3><\/dt>\n
cs_<\/code> and is shown on the askagento.com page you reached after paying. Only you see that page, which is what proves the purchase is yours. Your larger catalogue capacity and monthly allowances apply within about a minute. If you no longer have the code, email hi@askagento.com<\/a> with your Stripe receipt and we will link it for you.<\/p>\n\nHow do I change plan, update my card, get invoices, or cancel?<\/h3><\/dt>\n