Skip to content
For the complete documentation index, see llms.txt. This page is also available as Markdown.

Plugin settings

Reference of the plugin configuration in Shopware: the cards "Global configuration" and "Search configuration" with the effect and default of every setting.

Plugin configuration with the Sections sidebar, sales channel selection and support card

You reach the plugin configuration via Extensions → My extensions or directly in the plugin dashboard via "Plugin configuration". This page is the reference for the cards "Global configuration" and "Search configuration". The other cards are described under More configuration cards.

How the configuration is built

Sales channel inheritance. At the top you choose "All sales channels" or a single sales channel. Values you set under "All sales channels" are inherited by all channels as long as a channel does not override them. As usual in Shopware, a lock icon at the field shows whether a value is inherited. The search configuration can be maintained per sales channel. One exception is the "Live synchronisation", which always applies to all sales channels.

"Sections" sidebar. From a window width of 1100 pixels, a "Sections" sidebar on the left lists all cards of the configuration. A click jumps to the card and expands it if needed. The card you are currently in is highlighted. Below it you find the support and the link "To the plugin dashboard".

Expanding and collapsing. You expand or collapse cards by clicking the title. With "Expand all" and "Collapse all" below the list you switch all at once. Your browser remembers the choice.

Global configuration

This card connects your shop with InsightSearch.

Setting
Effect
Default

"Account secret"

Secret key of your InsightSearch account (password field).

empty

"Installation secret"

Secret key of this shop installation (password field).

empty

"Test connection"

Checks the connection. It reports success or asks you to check the account and installation secrets.

As a rule the keys already hold the right values after the setup wizard. Change them only if you connect an existing installation or support asks you to. More about setup under Installation and setup.

Search configuration

The card contains almost all settings that concern the look and behaviour of the search in the shop. You can maintain them per sales channel. The tables below group them by topic. Detail pages: Search in the shop, Search on mobile, Customize design, Search results page and No results.

Activation

Setting
Effect
Default

"Enable search"

Switches on the InsightSearch search in the shop. It only works for languages with an assigned search index.

off

"Search activation mode"

Defines when and how the search window opens (see below).

"Use Shopware standard search field"

"Trigger selector"

The CSS selector of the element that opens the search in the mode "Activate via external trigger", for example .my-search-button or #open-search.

empty

Selection of the search activation mode

The four activation modes:

  • "Use Shopware standard search field": The plugin attaches to your theme's search field. With heavily customised themes this may not work properly.

  • "Search field always visible": The plugin creates its own search field. Here too the theme may affect display or function.

  • "Activate via external trigger": For cases where the first two do not work. You enter the CSS selector of the element that should open the search.

  • "Activate via search button": In addition to the standard mode, a click on the magnifier opens the search window.

Display

Setting
Effect
Default

"Search popup layout"

Arrangement and card design: "Grid with detailed cards (default)", "Compact list", "Compact grid", "Carousel" or "Native Shopware design (InsightSearch results, no popup)". With the native design Shopware's suggestion window stays, InsightSearch delivers the results.

Grid with detailed cards

"Image for products without an image"

An image from the Shopware media for products without an image or whose image does not load. Applies in the search window, in replacement products and in the shopping assistant.

none (grey placeholder)

"Search field placeholder"

Text in the empty search field, only in the field that the plugin creates itself.

"Enter search term..."

"Search field placeholder per language"

One line per language in the format en-GB=What are you looking for?. A short code such as en applies to all English languages.

empty

"Show badges on search result cards"

Shows small labels (up to 2) on the cards if badge data exists.

off

"Enable quick view on search result cards"

Adds a button to every card that opens Shopware's quick view without leaving the search window. No effect in the layout "Native".

off

"Add-to-cart button in the search overlay"

Shows a cart button on every card. Simple products are added directly, products with variants show "Choose options", sold-out products no button. No effect in the layout "Native".

off

"Show base prices and units in search"

Shows base prices with unit on the cards, if available.

off

"Hide prices in search"

Hides all prices on the cards.

off

"Show prices with UVP prefix"

Puts "UVP" in front of the displayed prices.

off

"Show live prices from Shopware (Beta)"

Loads the real, customer-specific price for every visible result (advanced price rules, price plugins) and shows it in Shopware's price display. One extra query per search. Not together with "Hide prices in search" or "Show prices with UVP prefix".

off

"Use rounded corners"

On: rounded corners (0.625 rem). Off: square.

on

"Custom search colors (CSS variables)"

Overrides the colours of the search, one line per variable. The field is pre-filled, the list is under Customize design.

pre-filled

"Custom stylesheet for search"

Your own CSS for the search; only works if the search is active and the layout is not "Native".

empty

"Replace base styling with custom CSS"

Removes the default design of the search. Use only if your CSS contains all rules. The rules for the mobile designs and "Filters on mobile devices" stay.

off

Results

Setting
Effect
Default

"Number of search results (per page)"

How many results are loaded per request.

12

"Minimum number of characters for search"

From this many characters, product results appear. Suggestions appear from 1 character. Smallest value 1.

3

"Number of search suggestions"

How many suggestions are shown. Allowed are 1 to 10.

5

"Enable pagination for search results"

Shows the button "Load more results" at the bottom. Off: only the first page.

on

Search strategy

Choice
Effect
Default

"Standard: balanced results (recommended)"

Balanced between precision and number of results, for most shops.

yes

"Precise: exact article number search"

For B2B and specialist shops: finds article numbers exactly and does not fall back to typo tolerance.

"Explorative: as many results as possible, tolerates typos"

For fashion and lifestyle: as many results as possible, tolerant of typos.

Search results page and variants

Setting
Effect
Default

"Allow redirect to Shopware search results page on Enter"

Enter in the search field submits the Shopware search form and opens the standard search results page.

off

"Deliver Shopware search results page via InsightSearch"

Enter opens Shopware's search results page, but the results and ranking come from InsightSearch. Theme, filter bar, sorting, paging and SEO stay with Shopware. Filters narrow down within the InsightSearch results. Not compatible with an active Elasticsearch/OpenSearch integration for products.

off

"Maximum number of results on the search results page"

Upper limit for the delivered results, 1 to 10000. Larger values mean more queries on the first search for a term.

2000

"Combine variants of the same product into one hit"

Combines variants into one tile, like Shopware's list. Search window and page show the same number of results. Filter counters still count variants.

on

"Allowed external hosts for search term redirects"

Further domains that search term rules may redirect to, one per line (for example blog.example.com). Relative paths and the domains of the sales channel are always allowed.

empty

"Restore search when going back"

If a customer goes back in the browser after a product click, the window opens with search term, filters, loaded results and scroll position. Applies for 30 minutes in the same tab.

on

Filters

Setting
Effect
Default

"Enable filter rendering"

Shows filters in the search window. Without this switch there are no filters, no active filters and no filter buttons.

off

"Default filter group state"

"Open (all expanded)" or "Closed (all collapsed)" if no individual setting is made per filter.

Open

"Visible options per filter"

How many options are visible, 1 to 50. Further options appear via "Show more".

5

"Filters on mobile devices"

For screens below 992 pixels: "Show as before", "Collapse behind a filter button" or "Hide". Active filters always stay visible as removable selections.

Show as before

CMS pages

Setting
Effect
Default

"CMS page for empty search state"

A shopping experience shown when the search is opened without a search term. Without a selection, the default text appears.

no selection

"CMS page for search without results"

A shopping experience instead of the default message. The field exists only with the paid add-on "CMS for no results"; otherwise the configuration shows a notice.

no selection

Mobile devices

Setting
Effect
Default

"Design on mobile devices"

Applies below 768 pixels: "As before", "Compact bars", "Results first" or "App style". No effect in the layout "Native".

As before

"Products on mobile devices"

Applies below 768 pixels: "Automatic as before", "List" or "Grid with two columns".

Automatic as before

"Number of suggestions on mobile devices"

Empty: same as "Number of search suggestions". 0: no suggestions as long as there are results. Allowed are 0 to 10. A hint about a typo always stays visible.

empty

The effect of the designs is explained in Search on mobile.

Working together with Cross-Selling Pro

If the plugin "Cross-Selling Pro - KI Cross Selling" is installed in the same shop, connected to InsightSearch and has a recommendation index, the following switch is usable. Otherwise it is greyed out and shows a notice. An already saved value is kept.

Setting
Effect
Default

"Goes with" in the search overlay

Up to four matching products for the first result appear below the results. The cart button follows the setting "Add-to-cart button in the search overlay".

on (without a saved value)

The second switch of this cooperation, "Replacement products from Cross-Selling Pro - KI Cross Selling", is on the card "No results & related results". It is described on the page More configuration cards.

Read on

More configuration cardsSearch in the shopCustomize designStatistics

Last updated