{"id":384096,"date":"2026-10-24T09:59:51","date_gmt":"2026-10-24T09:59:51","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/f12-shop-search\/"},"modified":"2026-10-24T10:31:35","modified_gmt":"2026-10-24T10:31:35","slug":"f12-shop-search","status":"publish","type":"plugin","link":"https:\/\/wordpress.org\/plugins\/f12-shop-search\/","author":16900441,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"1.48.1","stable_tag":"1.48.1","tested":"7.1.3","requires":"6.0","requires_php":"7.4","requires_plugins":null,"header_name":"Shop Search for WooCommerce","header_author":"Forge12 Interactive GmbH","header_description":"Product search for WooCommerce and WordPress: suggestions as you type, SKUs, \u201cDid you mean\u201d, sections and insights\u2014no cloud.","assets_banners_color":"8195d0","last_updated":"2026-10-24 10:31:35","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/www.forge12.com\/en\/shop\/woocommerce-product-search\/","header_author_uri":"https:\/\/www.forge12.com","rating":0,"author_block_rating":0,"active_installs":0,"downloads":76,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.48.0":{"tag":"1.48.0","author":"forge12","date":"2026-10-24 09:59:32","revision":3763031},"1.48.1":{"tag":"1.48.1","author":"forge12","date":"2026-10-24 10:31:35","revision":3763080}},"upgrade_notice":[],"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3763031,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3763031,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3763067,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3763067,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"forge12-search\/suchfeld":{"name":"forge12-search\/suchfeld","title":"Search field (F12)"},"forge12-search\/ergebnisse":{"name":"forge12-search\/ergebnisse","title":"Search results (F12)"}},"tagged_versions":["1.48.0","1.48.1"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3763067,"resolution":"1","location":"assets","locale":"","width":1280,"height":800},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3763067,"resolution":"2","location":"assets","locale":"","width":1280,"height":1150},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3763067,"resolution":"3","location":"assets","locale":"","width":1440,"height":900},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3763067,"resolution":"4","location":"assets","locale":"","width":1440,"height":900},"screenshot-5.png":{"filename":"screenshot-5.png","revision":3763067,"resolution":"5","location":"assets","locale":"","width":1000,"height":1124},"screenshot-6.png":{"filename":"screenshot-6.png","revision":3763067,"resolution":"6","location":"assets","locale":"","width":1280,"height":800},"screenshot-7.png":{"filename":"screenshot-7.png","revision":3763067,"resolution":"7","location":"assets","locale":"","width":1280,"height":800},"screenshot-8.png":{"filename":"screenshot-8.png","revision":3763067,"resolution":"8","location":"assets","locale":"","width":1280,"height":1100}},"screenshots":{"1":"The suggestion list as you type \u2013 completions and products with image and price.","2":"The results page with tabs per section, category cards and sorting.","3":"Overview: what the search did in the last days and what would help now.","4":"Insights: frequent searches and searches without results.","5":"Settings for the suggestion list, with live preview.","6":"Type a SKU \u2013 the suggestion list finds the product by its article number.","7":"A typo: \u201cDid you mean \u2026?\u201d points to the word that has results.","8":"\u201cAll\u201d as a grouped overview with matching categories and a section for every content type."}},"plugin_section":[],"plugin_tags":[3226,5185,5183,944,286],"plugin_category":[45],"plugin_contributors":[172866],"plugin_business_model":[],"class_list":["post-384096","plugin","type-plugin","status-publish","hentry","plugin_tags-autocomplete","plugin_tags-live-search","plugin_tags-product-search","plugin_tags-search","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-forge12","plugin_committers-forge12"],"banners":{"banner":"https:\/\/ps.w.org\/f12-shop-search\/assets\/banner-772x250.png?rev=3763067","banner_2x":"https:\/\/ps.w.org\/f12-shop-search\/assets\/banner-1544x500.png?rev=3763067","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/f12-shop-search\/assets\/icon-128x128.png?rev=3763031","icon_2x":"https:\/\/ps.w.org\/f12-shop-search\/assets\/icon-256x256.png?rev=3763031","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/f12-shop-search\/assets\/screenshot-1.png?rev=3763067","caption":"The suggestion list as you type \u2013 completions and products with image and price."},{"src":"https:\/\/ps.w.org\/f12-shop-search\/assets\/screenshot-2.png?rev=3763067","caption":"The results page with tabs per section, category cards and sorting."},{"src":"https:\/\/ps.w.org\/f12-shop-search\/assets\/screenshot-3.png?rev=3763067","caption":"Overview: what the search did in the last days and what would help now."},{"src":"https:\/\/ps.w.org\/f12-shop-search\/assets\/screenshot-4.png?rev=3763067","caption":"Insights: frequent searches and searches without results."},{"src":"https:\/\/ps.w.org\/f12-shop-search\/assets\/screenshot-5.png?rev=3763067","caption":"Settings for the suggestion list, with live preview."},{"src":"https:\/\/ps.w.org\/f12-shop-search\/assets\/screenshot-6.png?rev=3763067","caption":"Type a SKU \u2013 the suggestion list finds the product by its article number."},{"src":"https:\/\/ps.w.org\/f12-shop-search\/assets\/screenshot-7.png?rev=3763067","caption":"A typo: \u201cDid you mean \u2026?\u201d points to the word that has results."},{"src":"https:\/\/ps.w.org\/f12-shop-search\/assets\/screenshot-8.png?rev=3763067","caption":"\u201cAll\u201d as a grouped overview with matching categories and a section for every content type."}],"raw_content":"<!--section=description-->\n<p>The built-in WordPress search finds a title when it is typed exactly as\nwritten. It does not find the SKU, the category, or the word with a typo.\nShop Search for WooCommerce turns it into a shop search that understands what your\ncustomers mean \u2013 and shows you what they did not find.<\/p>\n\n<p>Everything runs in your own WordPress database. The plugin contacts no\nexternal service.<\/p>\n\n<p><strong>At a glance<\/strong><\/p>\n\n<ul>\n<li>Live suggestions with image, price and stock status \u2013 from two characters on<\/li>\n<li>Finds SKUs, categories and tags, ranked by relevance<\/li>\n<li>\u201cDid you mean \u2026?\u201d checked against the real number of results<\/li>\n<li>Results page with tabs per section, sorting and an empty state that helps<\/li>\n<li>Search log with the searches that found nothing \u2013 your shopping list of\nmissing products and words<\/li>\n<li>Blocks, Elementor widgets, shortcodes and filter hooks<\/li>\n<li>No cloud, no tracking, no external requests<\/li>\n<\/ul>\n\n<p>Need synonyms, automatic typo correction, filters or rules per search term?\nThey are part of the separate plugin\n<a href=\"https:\/\/www.forge12.com\/en\/shop\/woocommerce-product-search\/?utm_source=wporg-free&amp;utm_medium=readme&amp;utm_campaign=top\">F12 Shop Search Pro<\/a>\n\u2013 see \u201cFree and Pro\u201d below.<\/p>\n\n<p><strong>As you type<\/strong><\/p>\n\n<ul>\n<li><strong>Suggestion list<\/strong> from two characters on: word completions and the\nmatching products with image, price, \u201cSale\u201d and \u201cOut of stock\u201d, plus the\nSKU when it was what matched.<\/li>\n<li><strong>Popular products<\/strong> on the first click into an empty search field\n(optional).<\/li>\n<li>Width, corner radius and colors of the list are adjustable, with a live\npreview.<\/li>\n<li>Cached and rate-limited, so a script hammering the endpoint does not slow\ndown your shop.<\/li>\n<\/ul>\n\n<p><strong>What is found<\/strong><\/p>\n\n<ul>\n<li><strong>SKUs<\/strong>, including those of variations \u2013 the product is found.<\/li>\n<li><strong>Categories and tags<\/strong> as search text; matching categories as cards above\nthe results.<\/li>\n<li><strong>Relevance:<\/strong> a full title match ranks before an SKU, before a category,\nbefore body text.<\/li>\n<li><strong>\u201cDid you mean \u2026?\u201d<\/strong> for typos, checked against the actual number of\nresults \u2013 no guessing.<\/li>\n<\/ul>\n\n<p><strong>On the results page<\/strong><\/p>\n\n<ul>\n<li><strong>Tabs per section<\/strong> (All \u00b7 Products \u00b7 Posts \u00b7 Pages \u2026) with result counts;\n\u201cAll\u201d as a grouped overview. Sections combine any content types.<\/li>\n<li><strong>Sorting<\/strong>, unit price, pack sizes and badges on the product card.<\/li>\n<li><strong>Empty state<\/strong> with tips and categories instead of a dead end.<\/li>\n<li>The plugin's own results page, your theme's, or a page you design\nyourself, with any theme \u2013 tested with Twenty Twenty-Five and Twenty\nTwenty-One.<\/li>\n<\/ul>\n\n<p><strong>Insights<\/strong><\/p>\n\n<ul>\n<li><strong>Search log<\/strong> in your own database: frequent searches and searches without\nresults for the last 7, 30 or 90 days \u2013 the list that tells you which\nproducts or words your shop is missing.<\/li>\n<\/ul>\n\n<p><strong>Fits in<\/strong><\/p>\n\n<ul>\n<li><strong>Blocks<\/strong> for the block editor, <strong>Elementor widgets<\/strong> and shortcodes.<\/li>\n<li>Every setting is also available as a <strong>filter hook<\/strong> \u2013 for developers. A\nfilter always wins over the setting; the hook name is shown next to each\nfield.<\/li>\n<\/ul>\n\n<p><strong>Free and Pro<\/strong><\/p>\n\n<p>This plugin is complete on its own. For shops with a large range, many\nspellings of the same product, or a team that tunes the search every week,\n<a href=\"https:\/\/www.forge12.com\/en\/shop\/woocommerce-product-search\/?utm_source=wporg-free&amp;utm_medium=readme&amp;utm_campaign=comparison\">F12 Shop Search Pro<\/a>\nis a separate plugin from Forge12 that adds:<\/p>\n\n<ul>\n<li><strong>Synonyms with a visual editor<\/strong> \u2013 connect terms, categories and products\nwith a line, so \u201cwholemeal\u201d finds the \u201cwhole grain flour\u201d. Simulate the\nsearch first; get suggestions from real searches.<\/li>\n<li><strong>Typos corrected automatically<\/strong> \u2013 \u201cDinkl\u201d shows the results for \u201cDinkel\u201d\nright away, with a way back to the typed word.<\/li>\n<li><strong>Word forms and compound words<\/strong> \u2013 \u201cpans\u201d finds \u201cpan\u201d,\n\u201cwholegrainflour\u201d finds \u201cwhole-grain flour\u201d; only words from your own range,\nnothing guessed.<\/li>\n<li><strong>Filters on the results page<\/strong> \u2013 category, price (steps or slider),\navailability and any WooCommerce attribute, with the number of results at\nevery value; without reloading the page, as a panel on phones.<\/li>\n<li><strong>Rules per search term<\/strong> \u2013 pin a product to the top, hide results, or send\na search straight to a page.<\/li>\n<li><strong>Custom fields<\/strong> (also ACF) searched along.<\/li>\n<li><strong>Click rate per term<\/strong> and \u201csearched but rarely clicked\u201d, with a button\nthat creates the rule right there.<\/li>\n<li><strong>Search templates<\/strong> \u2013 carry the look of field, suggestion list, results\npage and filters over to the next site.<\/li>\n<li><strong>Avada<\/strong> Post Cards, icon sets and the search field in the header;\n<strong>WPML<\/strong> and <strong>Polylang<\/strong>.<\/li>\n<li><strong>Fast path<\/strong> for suggestions, delivered without loading plugins and theme.<\/li>\n<\/ul>\n\n<p><a href=\"https:\/\/www.forge12.com\/en\/shop\/woocommerce-product-search\/?utm_source=wporg-free&amp;utm_medium=readme&amp;utm_campaign=more\">See the comparison and Pro on forge12.com<\/a><\/p>\n\n<h3>Source code and third-party software<\/h3>\n\n<p>The settings screen is a React application. Its readable source code is in the\n    src\/ folder of the plugin; <code>build\/index.js<\/code> is generated from it. To rebuild:\n    npm install &amp;&amp; npm run build (Node.js 18 or later; the help chapters in\n    hilfe\/ are turned into <code>src\/hilfe\/inhalt.generated.js<\/code> by\n    tools\/hilfe-bauen.mjs).<\/p>\n\n<p>Bundled with the plugin:<\/p>\n\n<ul>\n<li>Inter variable font (<code>build\/fonts\/<\/code>) \u2013 SIL Open Font License 1.1,\nhttps:\/\/openfontlicense.org<\/li>\n<li>lucide-react icons \u2013 ISC license<\/li>\n<li>react-router \u2013 MIT license<\/li>\n<li>WordPress packages (<code>@wordpress\/components<\/code>, <code>element<\/code>, <code>i18n<\/code>, <code>api-fetch<\/code>) \u2013\nGPL-2.0-or-later<\/li>\n<\/ul>\n\n<p>The plugin's own code is licensed under GPL-2.0-or-later.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Install the plugin from the plugin directory (or upload the ZIP) and\nactivate it.<\/li>\n<li>Under <strong>Search \u2192 Results page<\/strong>, choose who renders the results page: the\nplugin template, your theme, or a page you design yourself.<\/li>\n<li>Optional: define sections under <strong>Search \u2192 Sections<\/strong>, and check the\nsuggestion list under <strong>Search \u2192 Suggestion list<\/strong>.<\/li>\n<\/ol>\n\n<p>Help for every page is built in under <strong>Search \u2192 Help<\/strong>.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"does%20it%20need%20woocommerce%3F\"><h3>Does it need WooCommerce?<\/h3><\/dt>\n<dd><p>No. Without WooCommerce, prices, unit prices and product badges simply do not\nappear; searching posts and pages works as before.<\/p><\/dd>\n<dt id=\"does%20it%20send%20data%20anywhere%3F\"><h3>Does it send data anywhere?<\/h3><\/dt>\n<dd><p>No. Search, suggestions and insights run in your WordPress database. The\nplugin makes no requests to external servers, and the admin pages load no\nexternal fonts or scripts. The links to forge12.com (support, feedback)\nare plain links.<\/p><\/dd>\n<dt id=\"what%20is%20the%20difference%20between%20this%20plugin%20and%20pro%3F\"><h3>What is the difference between this plugin and Pro?<\/h3><\/dt>\n<dd><p>Everything listed above works in this plugin without limits, forever. F12 Shop\nSearch Pro is a separate plugin with additional functions: synonyms, automatic\ntypo correction, word forms, filters on the results page, rules per search\nterm, custom fields, click rates, search templates and the Avada, WPML and\nPolylang integrations. Details on\n<a href=\"https:\/\/www.forge12.com\/en\/shop\/woocommerce-product-search\/?utm_source=wporg-free&amp;utm_medium=readme&amp;utm_campaign=faq\">forge12.com<\/a>.<\/p><\/dd>\n<dt id=\"what%20does%20the%20search%20log%20store%3F\"><h3>What does the search log store?<\/h3><\/dt>\n<dd><p>The search term, the section, filter and sort order, the number of results,\nthe device type (desktop, tablet, phone) and the time \u2013 no IP address, no user\nID, no cookies. Searches by administrators and by bots are not logged. The log\nis <strong>off after activation<\/strong>: nothing is stored until you turn it on under\n<strong>Search \u2192 Insights<\/strong>. Once on, it keeps entries for 90 days by default. The plugin suggests a paragraph for\nyour privacy policy under Settings \u2192 Privacy.<\/p><\/dd>\n<dt id=\"what%20is%20%E2%80%9Creport%20search%20terms%20to%20analytics%E2%80%9D%3F\"><h3>What is \u201cReport search terms to analytics\u201d?<\/h3><\/dt>\n<dd><p>If your site already runs Matomo, the plugin can pass each site search (term,\nsection, number of results) to Matomo's site-search report, in the visitor's\nbrowser. It is <strong>off by default<\/strong>: nothing is passed on until you turn it on\nunder <strong>Search \u2192 Insights<\/strong>. It adds no tracking of its own; without a Matomo\nsnippet on your site nothing is sent either way.<\/p><\/dd>\n<dt id=\"can%20i%20adapt%20the%20results%20template%3F\"><h3>Can I adapt the results template?<\/h3><\/dt>\n<dd><p>Yes: a file <code>f12shopsearch\/search.php<\/code> in your (child) theme replaces it, or use\nthe filter <code>f12shopsearch\/results_page\/template<\/code>.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>1.48.1<\/h4>\n\n<ul>\n<li>The plugin is now called \"Shop Search for WooCommerce\". The readme shows what the separate Pro plugin adds.<\/li>\n<\/ul>\n\n<h4>1.48.0<\/h4>\n\n<ul>\n<li>Products with a \"not sold individually\" notice are now listed after all other results and suggestions, in every sort order.<\/li>\n<\/ul>\n\n<h4>1.47.0<\/h4>\n\n<ul>\n<li>Internal changes only; no new features in this version.<\/li>\n<\/ul>\n\n<h4>1.46.1<\/h4>\n\n<ul>\n<li>Internal changes only; no new features in this version.<\/li>\n<\/ul>\n\n<h4>1.46.0<\/h4>\n\n<ul>\n<li>Internal changes only; no new features in this version.<\/li>\n<\/ul>\n\n<h4>1.45.0<\/h4>\n\n<ul>\n<li>Internal changes only; no new features in this version.<\/li>\n<\/ul>\n\n<h4>1.44.0<\/h4>\n\n<ul>\n<li>First release in the WordPress plugin directory.<\/li>\n<\/ul>","raw_excerpt":"Shop search for WooCommerce and WordPress: live suggestions, SKU search, \u201cDid you mean\u201d, sections and insights. No cloud, no external calls.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/384096","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=384096"}],"author":[{"embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/forge12"}],"wp:attachment":[{"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=384096"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=384096"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=384096"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=384096"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=384096"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=384096"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}