Centralised management of search keywords: installation and configuration

Installation instructions, documentation and FAQs for the Shopware plugin

Don’t miss out on any new features

Plugin news, updates and practical Shopware tips. Once a month.

Register now

Search keywords (the standard shopware field customSearchKeywords am Produkt) werden im Storefront-Suchindex besonders hoch gerankt — sie steuern also massgeblich, ob ein Produkt zu einer Kundensuche gefunden wird. Im Standard fehlen Redakteuren beim Anlegen oder Pflegen eines Produkts allerdings Vorschläge. Das führt schnell zu Variantenchaos: „T-Shirt”, „Tshirt” und „T Shirt” landen alle als eigenständige Begriffe im Index und zerfasern die Suche.

Das Plugin „Such-Schlagwörter zentral verwalten” liefert zwei Hilfsmittel, um die Schlagwortvergabe konsistent zu halten:

  1. Live suggestions in the product editor - When typing, all keywords already used on other products appear, including a frequency counter.
  2. Central administration in the settings — Übersicht über alle vergebenen Schlagwörter mit den Aktionen „Umbenennen” und „Löschen”, die auf alle betroffenen Produkte gleichzeitig wirken.

Prerequisites

  • Shopware 6 with access to the administration.
  • No external services or API keys required.
  • No migration necessary - existing keywords appear immediately in the overview.

Compatibility

  • Uses the standard product field customSearchKeywords - No interventions in the data kernel, no third-party plug-in dependencies.
  • Fully compatible with OpenSearch.
  • The storefront search index is updated automatically, as the Shopware standard indexer also writes during the DAL update.

Installation

  1. Purchase or rent the extension in the Shopware Store.
  2. In the Shopware backend under Extensions → My extensions install and activate.
  3. Clear the cache and reload the backend once (F5).

1 - Suggestions in the product editor

When maintaining a product, keywords that have already been assigned are suggested directly so that editors can adopt the canonical spelling with a single click - instead of typing a new variant.

  • Where: Product → Tab General → Area Search keywords.
  • What: When tapping, a dropdown appears with all the keywords already used on other products, including a counter showing the frequency.
  • Takeover: Clicking on a suggestion immediately adds the keyword to the product.

2 - Central administration

The central overview page bundles all keywords used in the shop and allows them to be renamed or removed for all affected products in a single step.

  • Where: Settings → Contents → Search keywords.
  • Overview: List of all keywords with the number of products for which they are stored.
  • Filter & Search: Language filter and full text search to quickly narrow down the list.
  • Aktion „Umbenennen”: Changes the keyword on all affected products in a single step - ideal for standardising variants.
  • Aktion „Löschen”: Removes the keyword from all products at the same time.

FAQs

No. Since the plugin is based on the standard shopware field customSearchKeywords the storefront search index is automatically updated via the Shopware standard indexer during the DAL update.

Yes, the plugin is fully OpenSearch-compatible. As only the Shopware standard field is written, the changes are transferred to the OpenSearch index as usual.

No. Existing keywords from the products appear in the central overview immediately after activation - no data migration is necessary.

Yes, suggestions and the central administration take the respective language into account so that you can maintain the keywords cleanly for each language.

The keyword is rewritten to the new value for all affected products. If the new value already existed for a product, it is not created twice there - the frequency counters in the overview are merged accordingly.

Support

If you have any questions or problems, please do not hesitate to contact us: