Everything about setup: search mode, AI provider, live search, cost protection, evaluation and synonyms.
Shopware 6.6 or 6.7 with storefront, PHP 8.2 or newer. Plus an account with an AI provider of your choice. Without one, only keyword recognition runs.
Under maximum search orders you set how many product types a query may be split into at most.
On the search page a bar shows how the query was understood. Every building block - category, colour, size, price, sorting - can be removed with a click and the search re-runs at once.
It can be switched off if you prefer. Leaving it on is worth it: customers understand why they see certain results.
Provider, model and key are entered by you. The key leaves your shop only to translate the search query.
You can select the colour and size properties. Without a selection the plugin detects properties with "Farbe", "Color", "Größe" or "Size" in their name.
If the customer names a category, the hits can be restricted to it.
Either the Stone & Water full-page modal or the Shopware standard.
The panel has a filter column on the left. Which filters appear and in what order is up to you; without a selection you get category, manufacturer, price and the three most common property groups.
On the phone the column becomes a button with the sorting below it. Groups can be expanded and the sliders are larger.
Hits appear in the plugin's own product tile, independent of the theme. Whether a buy button and availability show is up to you. Variants of the same article sit next to each other; on request the search shows only parent products.
A schedule of its own warms the cache and keeps the search index current. The scope is selectable: the most common filters, the largest property groups, or every group with all its values. The wider it reaches, the longer the run takes - in return, filter clicks work without waiting.
Stored answers last from one hour up to seven days, one day by default. After clearing, the maintenance warms up again straight away.
Four brakes worth setting before going live:
Enter your provider's token prices and the overview converts consumption into euros.
The search log records every search on the search page, translated and classic. The overview shows searches of the last 30 days split into AI, keyword and cache, plus average duration, queries without hits and failures.
Switch on click tracking and you also get click rate, click position and searches without a click. Retention in days is up to you; older entries are deleted automatically.
A customer word is replaced by a shop term before the search runs. The rules are kept as a table and can be tested individually.
The quickest route: the list of searches without hits contains the words your customers use and your shop does not know. Create the rule straight from there.
In the search test you check one query per sales channel, with or without AI. The breakdown and the number of hits are shown.
The batch test takes up to 50 queries, one per line, and shows the share with hits at the end. It is the quickest way to hold a list of real customer queries against your shop.
All settings initially apply to every channel. Select a channel at the top and it gets its own values - everything unchanged still comes from the default. One button resets it.
Since 1.1.85 inheritance can be controlled per field: for each sales channel you decide setting by setting whether it inherits from the default or gets a value of its own. The switch carries its label, and every settings area has an info icon with a short explanation.
We answer questions directly. Write to us via the contact form.
Every setting of the plugin with its default value and explanation, in the same order as in the administration. The texts come straight from the plugin (version 1.4.62).
Basics: whether the search is running and how it works.
Switches the AI search on or off for the selected sales channel.
Automatic only uses the AI for sentences and for price or sorting wishes. Always AI translates every search, including single words, while product numbers still run directly. This causes more AI calls.
From this word count a query counts as a sentence in automatic mode and goes to the AI. Possible values are 2 to 8. In automatic mode single words always use the classic search. To have them translated as well, set the search mode to Always.
At most this many product types are searched separately per query.
Provider, access key and model of the AI with a connection test, plus time limit, fallback without AI and how long answers are remembered.
One small call per search. Fast, affordable models are fully sufficient.
Only used to translate the search query.
Fast models are recommended, larger models hardly add value here.
If the model does not answer in time, the fallback takes over.
On failure or timeout, color, size, price and sorting are recognized without AI.
Passes the names of up to 80 categories and 30 property groups so the AI uses your terms. No products, no prices. Increases tokens per call.
Identical queries are answered without a new AI call for this long.
For every interpreted search the AI suggests two to four further search terms. They appear in the modal above the results, with zero results they come before the dictionary suggestions. No additional AI call.
How the search field appears and behaves in the shop: AI switch, buttons, Enter key and the integration into the theme.
With nothing shown or with the AI badge, the AI search stays on for all visitors. With the switch, visitors can turn it off and on themselves.
Applies to visitors who have not used the switch yet.
Defines whether the enter key opens the search result page or searches in the modal.
Switched off the customer stays in the modal and the search result page is no longer offered.
Shows a small cross in the search field as soon as something is typed. A click clears the input, keeps the focus in the field and shows the recommendations again.
CSS selector of the elements that open the modal, for example the magnifier icon of a customised theme. Separate several with a comma. Leave empty when the normal header search field is enough.
CSS selector of the search form if the theme does not use "form.header-search-form". Without a match and with a trigger set the plugin creates an invisible replacement form.
CSS selector of the elements to hide, for example the theme search field with its own suggestion list. Only set this once the trigger works.
Hides every search form of the theme, including ones that appear later, for example in the mobile drawer. The plugin field itself stays visible. Useful when the theme ships separate search fields for desktop and mobile.
Look, filters and behaviour of the live search in the window above the page, including preloading and AI while typing.
The modal opens full-screen with its own search field and fades in and out with a slight blur. Results appear as in the listing. The Shopware default stays the narrow dropdown at the search field.
Product boxes as in the listing or a compact list with image, name and price.
The own tile works without theme components and looks the same in every shop, but without wishlist and direct buy. The theme tiles adopt the look of your theme but can bring their own quirks.
Shows a "View product" button below the price. The whole tile is linked anyway, the button just makes it clearer.
Shows below the price whether the product is in stock.
Desktop from 1200 px, tablet from 768 px, smartphone below. The list always shows one column on smartphones.
The live search shows this many results on the first load. Default 12.
Shows the matching categories with result counts in the filter column. If the list below holds your own selection, that one wins.
Shows the matching manufacturers with result counts. If the list below holds your own selection, that one wins.
Shows the properties of the current results as filters, for example colour, size or material. Without your own list the most frequent groups appear.
Choose which filters appear in the modal, in which order and how they are shown. "Use standard filters" adds category, manufacturer, price and discount. Slider and from/to fields are available for properties with numbers, such as size or weight. Without a selection the plugin decides.
Shows a slider for the price range of the current results. If the list below holds your own selection, that one wins.
Shows behind each filter value how many results it yields. Tiles are counted like the result count at the top, i.e. a product with its variants as one tile. If variants appear individually, variants are counted. Off: the filter column only shows the values, the modal only lists values with results anyway.
Shows the group "Discount" in the filter column with "On sale", "from 20 %", "from 30 %" and "from 50 %", each with a count. Only steps with results appear. Calculated with the cheapest price like Shopware, i.e. with price rules and currency.
Defines whether the discount filter includes tier prices. Ignore: filtering uses the discount of the standard price from one piece, as the tile shows it with the list price. Include with hint: filtering uses the cheapest price including tiers, and an "i" behind the price shows the tier prices on hover.
Shows the shop sortings such as relevance or price at the top right of the modal.
Shows the reference price below the price, for example "(2.08 € / 1 piece)", plus the previous price when maintained. Applies to the cards in the live search.
Discounted products show the sale price together with the struck-through previous price and the saving. With from-prices there is no strike-through price, as in the Shopware listing. Theme tiles show strike-through prices anyway.
Discounted products show the saving in percent at the top right of the image, for example 13%. With from-prices it is left out, as in the Shopware listing. Applies to the own tile, theme tiles bring their own badge.
Background colour of the badge as a hex value, for example #1f2328. Choose it together with the text colour so the percentage stays easy to read.
Colour of the percentage in the badge as a hex value, for example #ffffff for white.
Shows matching categories as clickable suggestions above the result list, for example the accessory category of a brand when the brand name is typed. A click narrows the results to that category.
Defines how the filter column appears on narrow screens. On desktop it always stays next to the results.
Automatically loads the next results while scrolling in the modal, up to 120 products.
This many products are added while scrolling. 1 to 48, default 12. Independent of "Number of products" for the first load.
After that, loading stops and the customer moves on via "Show all results". 12 to 600, default 120.
Shows a button in the bottom right after some scrolling that jumps back to the top of the results.
Loads the next page and the nearby filters before the click, which makes the modal react instantly. On busy shops this creates extra requests, then switching it off is worth it.
Lean only preloads the nearby filters. All visible values makes every click on color, category or manufacturer instant but creates more requests. The calls are staggered so the shop does not get everything at once.
How long the live search waits after the last keystroke before asking. 0 to 1000, default 150. Higher values noticeably save requests, 250 to 300 still feels smooth.
The live search never calls the AI, it uses keyword recognition or cached results.
After a short typing pause, the AI already translates full sentences in the modal, and the search page afterwards loads without waiting. Causes additional AI calls, limited to 40 per visitor in ten minutes.
The input must rest this long before the AI is asked. 300 to 3000, default 700.
What the search modal shows before anything is typed: product recommendations and popular searches.
Opens the modal as soon as the search field is clicked, optionally with recommendations and popular searches. Empty saves a request, content then only appears while typing.
Where the products come from that appear on opening and on a search without hits.
One suggestion per line, shown as a clickable term. Full sentences that show what the AI search can do work well too.
Adds up to eight queries from the search log that were searched at least twice, had results and where a result was clicked at least once. They are visible to all visitors.
Queries containing one of these terms never appear as a popular search. One term per line.
Defines what a click on a term under "Popular searches" does.
Shows products in the selected sorting, view and products per row as above.
The modal shows this many products while nothing has been typed yet. 1 to 30, default 10.
Whether main products or variants appear, which variants are shown when filtering and how tiered prices are handled.
Every tile shows the main product instead of a variant. Products without variants are unaffected. While this is on, the variant mapping and the splitting when filtering do not apply.
When a variant stays as the tile because the main product is not visible in the sales channel, the name of the main product is shown anyway.
Instead of one tile per product every variant appears as its own result. Can be chosen separately for the live search and the search page. Note: the number of results grows considerably.
When variants are shown individually, the main product appears as its own tile before its variants. Also applies when variants are fanned out while filtering. The result count includes it.
When the search hits a product with variants, its other variants appear as separate tiles right after the hit, for example further colours or sizes. Invisible variants and sold-out closeout items are left out. The result count includes them.
Limits the additional variants per product so that products with a great many shades do not fill the list. Possible values are 1 to 50.
What appears when filtering by colour, size or another property, or when the property is part of the search term. With all matching variants, a product in red and yellow appears twice when both colours are selected.
Every variant that appears as its own tile shows its own image, if one is assigned. This applies whether it comes from showing variants individually, from filtering or as a further variant of a product found. Without its own image the main image remains.
The tile shows a fixed price instead of a from-price: with main products only the price from the master data, otherwise the price of the variant. Tiered prices and the variant price range are left out.
Hints and filters on the search results page.
Shows the translation on the search page and makes every part removable with one click.
Shows a category filter with result counts and a search field in the search results. Shopware otherwise only offers manufacturer, price, rating and properties there.
The filter shows this many categories, sorted by result count. 3 to 100, default 20.
Which categories the filter shows. Parent first: by number of results, main categories on top. Deepest only: only the deepest categories of the results, e.g. "Girls" instead of "Wallpaper". Applies to the filter column, quick filters and search page. Selected categories always stay visible.
Shows the most frequent categories of the current search as clickable buttons above the result list.
Applies to the quick filters above the results and to the values per group in the modal filter column. 1 to 12, default 6.
How many property groups the filter column shows without a custom order, most frequent first. Groups with "Display in product filter" switched off in Shopware do not appear. For fixed groups like colour, maintain the order under "Filters and order".
How a search turns into results: categories and properties as filters, preferred manufacturers, synonyms and what happens when nothing is found.
If the customer names a category, the results are limited to it.
Applies to all properties unless the filter list says otherwise. With OR one of the selected values is enough, with AND a product must have all of them. It can be overridden per group in the filter list.
If the query contains the name of a property value next to the actual search word, for example a color or a size, it becomes a filter. Only products with that value appear, the counts match and the tile shows the right variant. If the search consists of the property only, nothing is filtered, so products that merely carry the word in their name still appear. A filter set by the customer takes precedence.
Also recognises colors and sizes that are only used as variant options and whose group is not marked as filterable. Shopware then shows the matching variant instead of the main product.
Products of these manufacturers rank higher when the match is equal. Nothing is filtered out, other manufacturers stay in the list. Works with sorting by relevance, on the search page and in the live search.
1 nudges them up, 10 puts them in front almost always. Default 3.
On the left the term from your shop, on the right the words of your customers, separated by commas. Use the test field to check which word gets replaced.
If the search finds no hits, the product name is searched directly as well. This helps with long names whose individual words the Shopware search index does not know. Every entered word has to appear in the name.
How many terms appear as clickable suggestions when a search finds nothing. 1 to 12, default 6.
If the search finds nothing, the plugin compares every word with the shop search dictionary and repeats the search with the correct spelling. A note above the results tells the customer.
Limits for AI calls, protection against bots and waiting times.
After that, the search uses keyword recognition until midnight. 0 means no limit.
Maximum AI calls per visitor in ten minutes, search page and live search combined. 0 means no limit.
Search engines, crawlers and scripts get keyword recognition so they cause no AI costs.
If the AI does not answer this fast, the search page shows the keyword result and the AI finishes in the background. 500 to 10000, default 1500.
Optional, for the cost estimate in the overview. You find the price at your AI provider.
Optional, for the cost estimate in the overview.
The live search cache including warming, the Shopware search vocabulary and the search log.
Allows the live search responses into the HTTP cache. Shopware otherwise always passes this route through, so every keystroke costs a full query. Identical searches then work without the database.
Upper limit for a stored response. 30 to 604800 seconds, default 86400, which is one day. When products, prices or stock change, Shopware drops the affected responses right away, as does clearing the cache. A long value is therefore safe and saves the most load.
How long the visitor browser keeps a response. This avoids the request on the next page view, for example when the same filter is hovered again. 0 to 300, default 60. The value applies to this one visitor only, 0 switches it off.
Defines what is warmed: the most frequent customer search terms from the log, for the most frequent ones also the intermediate steps while typing, plus categories and manufacturers of the channel and combinations with properties. "Everything" can run for a while on large catalogues.
Calls the most frequent search terms, the category names and the same searches with all property groups as a filter, for example colour, size or material. Afterwards the common responses are cached.
Warms the cache automatically at the chosen interval, without a click in the module. After clearing the cache the next run starts right away instead of waiting for the interval. It runs through the Shopware scheduled tasks, so the worker has to be active.
When the cache is cleared, for example via "Clear caches", after an update or when the theme is rebuilt, all warmed responses are gone. With this option the plugin notices this within five minutes and warms again on its own. Requires a running background worker for scheduled tasks.
The search uses its own index instead of the Shopware full text search. It finds word beginnings and word parts, including terms inside compound words, as well as numbers, manufacturers and variant options. Synonyms apply in both directions, typos are tolerated. When a product is saved or imported, only its entries are renewed. After an update the maintenance task builds the index in the background, until then Shopware searches as before. The button does it right away.
Adds the properties of the products to the search index, own ones or inherited from the parent, e.g. colour, material or type. They find the product but rank behind name, number and manufacturer. After switching on or off, press "Build index" once.
Adds the words of the product description to the search index, at most 200 per product and from four letters. Matches via the description rank behind matches via name, number and manufacturer. The index gets larger. After switching on or off, press "Build index" once.
A search returns at most this many products, best matches first. Result count and filters are calculated over these products. More results make broad searches more complete but somewhat slower. Default 3,000, possible 500 to 10,000.
Finished live search responses are stored in a table of their own, independent of the Shopware cache. Clearing caches, updates and theme rebuilds leave them untouched. When a product changes, only the responses containing it are dropped and warmed again. Orders drop nothing. Applies when live search caching is switched on.
The property filters of category pages come from a prepared table of their own instead of Shopware counting across all variants. This speeds up filter clicks especially in large categories. After switching on, press "Build index" once, afterwards the table is kept up to date per product together with the search index. Categories with dynamic product groups as well as active price, rating or shipping filters are still calculated by Shopware.
Rewrites the search index completely at the configured interval, as a safeguard in addition to the ongoing update of single products. The search keeps working meanwhile.
How often the maintenance runs. 1 to 168, default 24. The task itself reports hourly and only checks whether the interval has been reached.
Stores translated queries for overview and analysis.
Records which product is clicked after a search and at which position. Only the query, product and position are stored, no personal data.
Older entries are deleted automatically.
All prices net, plus VAT.
Download the free Plugin Suite and upload it in the admin, no SSH needed. It installs and updates the plugin with one click. You buy the licence directly from us, with an invoice from us and support straight from the developer.
The plugin will be listed in the official Shopware Community Store. Installation and automatic updates then run through the plugin manager in the backend, billing through your Shopware account. We will link it here as soon as it is available.