{"id":301072,"date":"2026-07-09T13:24:48","date_gmt":"2026-07-09T13:24:48","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/searchus-site-search-smart-404-recovery\/"},"modified":"2026-08-24T19:44:49","modified_gmt":"2026-08-24T19:44:49","slug":"searchus","status":"publish","type":"plugin","link":"https:\/\/arg.wordpress.org\/plugins\/searchus\/","author":23463866,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.0.7","stable_tag":"2.0.7","tested":"7.0.4","requires":"5.9","requires_php":"7.4","requires_plugins":null,"header_name":"SearchUs \u2013 Site Search for WordPress and WooCommerce","header_author":"FunnelWon","header_description":"Intelligent indexing, intent scoring, and SERP control for WordPress.","assets_banners_color":"ebebeb","last_updated":"2026-08-24 19:44:49","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"","header_author_uri":"https:\/\/searchus.funnelwon.com","rating":5,"author_block_rating":0,"active_installs":0,"downloads":483,"num_ratings":1,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.0":{"tag":"1.0.0","author":"funnelwon","date":"2026-07-09 13:24:32"},"1.0.1":{"tag":"1.0.1","author":"funnelwon","date":"2026-07-09 20:56:15"},"1.0.2":{"tag":"1.0.2","author":"funnelwon","date":"2026-07-30 02:12:42"},"1.0.3":{"tag":"1.0.3","author":"funnelwon","date":"2026-08-07 17:22:56"},"1.0.4":{"tag":"1.0.4","author":"funnelwon","date":"2026-08-07 17:37:13"},"2.0.0":{"tag":"2.0.0","author":"funnelwon","date":"2026-08-12 03:47:06"},"2.0.1":{"tag":"2.0.1","author":"funnelwon","date":"2026-08-12 04:00:47"},"2.0.2":{"tag":"2.0.2","author":"funnelwon","date":"2026-08-12 21:38:42"},"2.0.3":{"tag":"2.0.3","author":"funnelwon","date":"2026-08-15 03:34:31"},"2.0.4":{"tag":"2.0.4","author":"funnelwon","date":"2026-08-15 04:02:48"},"2.0.5":{"tag":"2.0.5","author":"funnelwon","date":"2026-08-15 04:58:11"},"2.0.6":{"tag":"2.0.6","author":"funnelwon","date":"2026-08-15 05:05:52"},"2.0.7":{"tag":"2.0.7","author":"funnelwon","date":"2026-08-24 19:44:49"}},"upgrade_notice":{"2.0.7":"<p>Improved phrase synonyms for clearer intent matching on multi-word searches.<\/p>","2.0.4":"<p>Shows the plan-cap reindex summary with Crawl Inclusion guidance before the admin page reloads.<\/p>","2.0.3":"<p>Improves large-site reindex handling and clearly reports API plan-cap results with Crawl inclusion guidance.<\/p>","2.0.2":"<p>Fixes mobile search result grids so product and media tiles fit the screen without sideways scrolling.<\/p>","2.0.1":"<p>Shortens the WordPress admin sidebar menu to \u201cSearchUs.\u201d<\/p>","2.0.0":"<p>Major ecommerce and embed release: Search Embeds shortcodes, product filter drawer, natural-language price filters, variation pickers &amp; option aliases.<\/p>","1.0.4":"<p>SERP Background paints solid white by default; use Transparent \/ match theme if you want the theme background to show through.<\/p>","1.0.3":"<p>Updates Shopping tab tile styling to match Images and other grid SERP layouts.<\/p>","1.0.2":"<p>Updated plugin description on WordPress.org.<\/p>","1.0.1":"<p>Fixes license activation on Kinsta and other staging preview hosts, and on sites with plain permalinks. Update, then re-save your license in SearchUs settings if activation failed before.<\/p>","1.0.0":"<p>First public release. Complete free or paid license activation in SearchUs settings, then run a full reindex so indexing and visitor search use the API.<\/p>"},"ratings":{"1":0,"2":0,"3":0,"4":0,"5":1},"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3601545,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3601545,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3601545,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3601545,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":[],"tagged_versions":["1.0.0","1.0.1","1.0.2","1.0.3","1.0.4","2.0.0","2.0.1","2.0.2","2.0.3","2.0.4","2.0.5","2.0.6","2.0.7"],"block_files":[],"assets_screenshots":{"screenshot-1.jpg":{"filename":"screenshot-1.jpg","revision":3601545,"resolution":"1","location":"assets","locale":"","width":1246,"height":1800},"screenshot-10.jpg":{"filename":"screenshot-10.jpg","revision":3601545,"resolution":"10","location":"assets","locale":"","width":1079,"height":857},"screenshot-11.jpg":{"filename":"screenshot-11.jpg","revision":3601545,"resolution":"11","location":"assets","locale":"","width":892,"height":709},"screenshot-2.jpg":{"filename":"screenshot-2.jpg","revision":3601545,"resolution":"2","location":"assets","locale":"","width":1246,"height":3904},"screenshot-3.jpg":{"filename":"screenshot-3.jpg","revision":3601545,"resolution":"3","location":"assets","locale":"","width":1246,"height":2269},"screenshot-4.jpg":{"filename":"screenshot-4.jpg","revision":3601545,"resolution":"4","location":"assets","locale":"","width":1457,"height":1288},"screenshot-5.jpg":{"filename":"screenshot-5.jpg","revision":3601545,"resolution":"5","location":"assets","locale":"","width":1076,"height":855},"screenshot-6.jpg":{"filename":"screenshot-6.jpg","revision":3601545,"resolution":"6","location":"assets","locale":"","width":1079,"height":857},"screenshot-7.jpg":{"filename":"screenshot-7.jpg","revision":3601545,"resolution":"7","location":"assets","locale":"","width":1077,"height":856},"screenshot-8.jpg":{"filename":"screenshot-8.jpg","revision":3601545,"resolution":"8","location":"assets","locale":"","width":1077,"height":856},"screenshot-9.jpg":{"filename":"screenshot-9.jpg","revision":3601545,"resolution":"9","location":"assets","locale":"","width":1077,"height":856}},"screenshots":{"1":"Included content: choose post types and media for the index, plus URL\/DOM exclusions and crawl-related options.","2":"Search experience (SERP): search page layout, redirect, results per page, list or tile view, excerpts, and visitor-facing search UI.","3":"Synonyms and intent detection: map phrases and intents so informal queries still match the right content.","4":"Auto-crawl and reindex logs: see scheduled and automatic index updates after content changes.","5":"Results page, list view: stacked results with titles, URLs, snippets, and thumbnails where available.","6":"Results page, tile view: grid layout for a more visual browse of results.","7":"Results page, Images tab: image-only results from indexed media (alt text, titles, filenames help relevance).","8":"Results, image pop-up: larger preview of an image result without leaving search.","9":"Results page, Videos tab: video results from indexed video content.","10":"Results, video pop-up: in-place playback for a video result.","11":"Results page, shopping tab: product-focused results when products are indexed (e.g. WooCommerce), respecting your ranking settings."}},"plugin_section":[],"plugin_tags":[55279,5183,3541,5184,5190],"plugin_category":[],"plugin_contributors":[270715],"plugin_business_model":[],"class_list":["post-301072","plugin","type-plugin","status-publish","hentry","plugin_tags-internal-search","plugin_tags-product-search","plugin_tags-site-search","plugin_tags-woocommerce-search","plugin_tags-wordpress-search","plugin_contributors-funnelwon","plugin_committers-funnelwon"],"banners":{"banner":"https:\/\/ps.w.org\/searchus\/assets\/banner-772x250.png?rev=3601545","banner_2x":"https:\/\/ps.w.org\/searchus\/assets\/banner-1544x500.png?rev=3601545","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/searchus\/assets\/icon-128x128.png?rev=3601545","icon_2x":"https:\/\/ps.w.org\/searchus\/assets\/icon-256x256.png?rev=3601545","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/searchus\/assets\/screenshot-1.jpg?rev=3601545","caption":"Included content: choose post types and media for the index, plus URL\/DOM exclusions and crawl-related options."},{"src":"https:\/\/ps.w.org\/searchus\/assets\/screenshot-2.jpg?rev=3601545","caption":"Search experience (SERP): search page layout, redirect, results per page, list or tile view, excerpts, and visitor-facing search UI."},{"src":"https:\/\/ps.w.org\/searchus\/assets\/screenshot-3.jpg?rev=3601545","caption":"Synonyms and intent detection: map phrases and intents so informal queries still match the right content."},{"src":"https:\/\/ps.w.org\/searchus\/assets\/screenshot-4.jpg?rev=3601545","caption":"Auto-crawl and reindex logs: see scheduled and automatic index updates after content changes."},{"src":"https:\/\/ps.w.org\/searchus\/assets\/screenshot-5.jpg?rev=3601545","caption":"Results page, list view: stacked results with titles, URLs, snippets, and thumbnails where available."},{"src":"https:\/\/ps.w.org\/searchus\/assets\/screenshot-6.jpg?rev=3601545","caption":"Results page, tile view: grid layout for a more visual browse of results."},{"src":"https:\/\/ps.w.org\/searchus\/assets\/screenshot-7.jpg?rev=3601545","caption":"Results page, Images tab: image-only results from indexed media (alt text, titles, filenames help relevance)."},{"src":"https:\/\/ps.w.org\/searchus\/assets\/screenshot-8.jpg?rev=3601545","caption":"Results, image pop-up: larger preview of an image result without leaving search."},{"src":"https:\/\/ps.w.org\/searchus\/assets\/screenshot-9.jpg?rev=3601545","caption":"Results page, Videos tab: video results from indexed video content."},{"src":"https:\/\/ps.w.org\/searchus\/assets\/screenshot-10.jpg?rev=3601545","caption":"Results, video pop-up: in-place playback for a video result."},{"src":"https:\/\/ps.w.org\/searchus\/assets\/screenshot-11.jpg?rev=3601545","caption":"Results page, shopping tab: product-focused results when products are indexed (e.g. WooCommerce), respecting your ranking settings."}],"raw_content":"<!--section=description-->\n<p>Replace WordPress\u2019s default search with a powerful site search plugin for WordPress and WooCommerce. SearchUs helps visitors quickly find pages, posts, WooCommerce products, images, videos, PDFs, documents, audio, and other media with fast, relevance-ranked results.<\/p>\n\n<p>SearchUs delivers a better search experience with customizable results, search intent, synonyms, Smart 404 recovery, and flexible search pages. WooCommerce shoppers can filter products, select variations, and buy from search results\u2014helping them find what they need faster with fewer clicks.<\/p>\n\n<p><strong>Key Features<\/strong><\/p>\n\n<p><strong>Better WordPress Search<\/strong>\nReplace WordPress\u2019s built-in search with fast, relevance-ranked site search across pages, posts, WooCommerce products, images, videos, PDFs, documents, audio, and other indexed content. Show results on a dedicated search page with tabs such as All, Products, Images, Videos, Documents, and Audio; choose list or grid layouts while keeping your site\u2019s header and footer.<\/p>\n\n<p><strong>WooCommerce Search Built for Shopping<\/strong>\nTurn product search into a shopping experience. Index your catalog, let customers filter by category, price, brand, color, size, and other attributes, and understand natural-language searches like \u201cunder $100.\u201d Shoppers can select color, size, and other options on variable products and use Buy Now to cart or checkout without opening the product page first. Map shopper language (for example \u201cXXL\u201d or \u201csneakers\u201d) to real variation options and intent synonyms so the right products rank and preselect. Optional AI Assist can draft those synonym and variation-alias maps for you.<\/p>\n\n<p><strong>Scoped Search Embeds<\/strong>\nPlace search boxes anywhere with a shortcode and choose exactly what visitors can search\u2014products, pages, posts, images, videos, documents, audio, selected categories, or your entire site. Ideal for shop pages, landing pages, and page builders.<\/p>\n\n<p><strong>Search Analytics &amp; Content Gaps<\/strong>\nSee what visitors are searching for\u2014including queries that return zero results\u2014so you can improve your site instead of guessing. Spot missing products or pages to create, decide which synonym maps to add, and focus ranking and content work where shoppers actually look. Analytics stay on your WordPress site when enabled.<\/p>\n\n<p><strong>Search Intent &amp; Synonyms<\/strong>\nUnderstand what visitors mean\u2014not just what they type. Built-in intent and synonym matching help connect searches like \u201clead gen\u201d with content about \u201clead generation.\u201d<\/p>\n\n<p><strong>\u201cDid You Mean?\u201d Suggestions<\/strong>\nReduce failed searches by suggesting better terms when no matching results are found.<\/p>\n\n<p><strong>Fully Customizable Search Ranking<\/strong>\nControl how results are ranked by adjusting the importance of titles, headings, content, URLs, media, products, pages, posts, and more. Promote your most important content to the top of search results.<\/p>\n\n<p><strong>Automatic Search Indexing<\/strong>\nKeep your search index up to date by automatically detecting content changes, crawling your sitemap, or performing a full site scan.<\/p>\n\n<p><strong>Promote Important Content<\/strong>\nFeature announcements, products, promotions, or key pages by inserting promoted results into search results.<\/p>\n\n<p><strong>Secure &amp; Reliable<\/strong>\nProtect your search experience with settings locking, plan-tier rate protection, and automated bot filtering to reduce abusive or junk search traffic before it consumes your usage.<\/p>\n\n<p><strong>Built to Scale<\/strong>\nWhether your site has dozens of pages or hundreds of thousands of products, SearchUs scales with your content while keeping WordPress search fast, organized, and easy to use.<\/p>\n\n<p><strong>Smart 404 Recovery<\/strong>\nRecover visitors before they leave by replacing dead-end 404 pages with relevant pages, posts, products, or media based on the requested URL.<\/p>\n\n<p><strong>Options<\/strong><\/p>\n\n<p>Use the SearchUs search results page, or keep your theme\u2019s default WordPress search template while benefiting from SearchUs indexing and relevance ranking.<\/p>\n\n<p>Choose which post types, products, and media types to index. Configure layouts, ranking, excerpts, results per page, Buy Now destination, excluded URLs, excluded page sections, and more from one settings area.<\/p>\n\n<p>Requires PHP 7.4 or later.<\/p>\n\n<p>After license activation, SearchUs securely communicates with the FunnelWon service for indexing, search queries, licensing, and plan usage. Free plans include \u201cSearch powered by FunnelWon\u201d attribution where applicable. Paid plans can remove attribution based on license level. SearchUs does not include third-party advertising or behavioral tracking.<\/p>\n\n<h3>External services<\/h3>\n\n<p>This plugin connects to <strong>FunnelWon SearchUs<\/strong> (hosted API and account dashboard at https:\/\/searchus.funnelwon.com). Use of the service is subject to our Terms and Privacy (links below).<\/p>\n\n<p><strong>When data is sent<\/strong><\/p>\n\n<ul>\n<li><strong>License activation \/ validation<\/strong> \u2013 When you enter or refresh an API key (and on periodic checks the plugin performs).<\/li>\n<li><strong>Indexing<\/strong> \u2013 When you run a full reindex, delta\/index push, or auto-crawl sends content to build or update the remote index.<\/li>\n<li><strong>Visitor search<\/strong> \u2013 After activation, each real visitor search query is sent to <code>POST \/v1\/query<\/code> so the service can score results and apply plan limits (unless blocked locally as junk; see below).<\/li>\n<li><strong>Usage and configuration<\/strong> \u2013 When the admin loads usage, reindex eligibility, or optional cloud settings backup\/sync features you use.<\/li>\n<\/ul>\n\n<p><strong>What is sent (summary)<\/strong><\/p>\n\n<ul>\n<li>Site URL, API key, plugin version, site identifier, and technical headers needed for authentication and plan routing.<\/li>\n<li>Content and metadata you enable for indexing (titles, body areas, headings, product fields, media alt text, filenames, etc.).<\/li>\n<li>Visitor <strong>search query text<\/strong> for live search (not used for third-party advertising).<\/li>\n<li>Aggregated usage for quotas (e.g. query counts, indexed URL counts, reindex allowance).<\/li>\n<\/ul>\n\n<p><strong>What stays on your server<\/strong><\/p>\n\n<ul>\n<li>Optional <strong>SearchUs analytics<\/strong> (if enabled) is stored in your WordPress database only.<\/li>\n<li><strong>Query guard<\/strong> (<code>core\/query-guard.php<\/code>) evaluates queries locally and <strong>does not<\/strong> send obvious bot\/scanner probes to the API or third parties.<\/li>\n<li>A <strong>search result cache<\/strong> (transients) may store recent API responses locally for performance; it is not shared with advertisers.<\/li>\n<\/ul>\n\n<p><strong>Legal<\/strong><\/p>\n\n<ul>\n<li>Terms of Service: https:\/\/searchus.funnelwon.com\/tos\/<\/li>\n<li>Privacy Policy: https:\/\/searchus.funnelwon.com\/privacy\/<\/li>\n<\/ul>\n\n<p>For more detail, see the <strong>Privacy<\/strong> section below and the in-plugin FAQ.<\/p>\n\n<h3>Privacy<\/h3>\n\n<p><strong>Licensing and API<\/strong><\/p>\n\n<p>When the plugin contacts FunnelWon's (SearchUs) services\u2014for <strong>license validation<\/strong>, <strong>indexing<\/strong>, <strong>search results<\/strong>, or <strong>configuration sync<\/strong>\u2014it may send your <strong>site URL<\/strong>, <strong>API key<\/strong> (if you have entered one), <strong>plugin version<\/strong>, and other technical data needed to operate the service. Your site URL is used among other things to apply your plan and <strong>allowed environments<\/strong> (for example production, staging, and development URLs permitted under your license). <strong>After you complete license activation<\/strong>, indexing and visitor search send the content and metadata described in the plugin and settings (e.g. pages, posts, products) and each search query to the API as needed to build the index and return results; see the Description and External services sections above. Before activation, those API-backed search flows are not used for front-end <code>?s=<\/code> requests.<\/p>\n\n<p><strong>Support (information you choose to share)<\/strong><\/p>\n\n<p>If you contact support, we may ask you to share <strong>diagnostic details<\/strong> so we can reproduce issues and spot conflicts\u2014for example your <strong>hosting provider or environment<\/strong>, <strong>active WordPress theme<\/strong> (name and version), and <strong>list of active plugins<\/strong>, often by pasting <strong>Tools \u2192 Site Health \u2192 Info<\/strong> from your admin. You decide what to send; we use it only to troubleshoot (including cache and plugin conflicts) and improve compatibility. Unless a future feature clearly discloses it and asks for consent, the plugin does <strong>not<\/strong> automatically upload your theme or full plugin list to us solely for support.<\/p>\n\n<p><strong>What the plugin sends automatically (no separate ad or marketing profile)<\/strong><\/p>\n\n<ul>\n<li><strong>Site identity and licensing:<\/strong> your site URL (and any staging\/dev URLs your license allows), <strong>API key<\/strong> if you enter one, <strong>plugin version<\/strong>, and related technical fields so we can validate the license, apply plan limits, and route API requests.<\/li>\n<li><strong>Indexing:<\/strong> text and metadata from the content types you enable (e.g. titles, excerpts, body areas, headings, product fields, image alt text, file names)\u2014only what is needed to build and update the search index.<\/li>\n<li><strong>Search:<\/strong> each <strong>visitor search query<\/strong> is sent to the service to compute results <strong>once license activation is complete<\/strong> (same as any hosted search). Until an API key is stored after activation, front-end <code>?s=<\/code> search uses WordPress\u2019s built-in search and is not sent to SearchUs for ranking. Queries are not used for third-party advertising; they are processed to return search results and for <strong>plan usage<\/strong> (e.g. query volume limits) where applicable.<\/li>\n<li><strong>Optional in-plugin analytics (if you turn it on):<\/strong> aggregated search and click metrics stored <strong>on your WordPress site<\/strong> in its database, as described in settings. A <strong>first-party cookie<\/strong> may be used for deduplication. This analytics data is <strong>not<\/strong> sent to FunnelWon for advertising; it stays on your server unless a future feature clearly says otherwise.<\/li>\n<\/ul>\n\n<p><strong>What we do not do<\/strong><\/p>\n\n<ul>\n<li>We do <strong>not<\/strong> sell your site URL, license details, index payloads, search queries, or support diagnostics to <strong>third parties for advertising<\/strong> or to build ad profiles.<\/li>\n<li>The plugin does <strong>not<\/strong> load third-party advertising or behavioral-tracking scripts for FunnelWon\u2019s benefit.<\/li>\n<li>We do <strong>not<\/strong> automatically upload your theme name, plugin list, or Site Health dump\u2014only what <strong>you<\/strong> choose to send if you contact support.<\/li>\n<\/ul>\n\n<p><strong>Personal data (PII) in plain language<\/strong><\/p>\n\n<p>SearchUs is <strong>not<\/strong> designed to collect visitor identities for marketing. However, <strong>search queries<\/strong> can contain anything a visitor types, and <strong>indexed content<\/strong> may include names, emails, or other data <strong>you<\/strong> published on the site\u2014those flows are part of normal search and indexing, not a separate \u201cPII harvesting\u201d feature. If you are a <strong>data controller<\/strong> for your site\u2019s visitors, you should describe SearchUs in <strong>your<\/strong> privacy policy (and comply with applicable law). FunnelWon\u2019s own handling of data received through the service is described in our policies below.<\/p>\n\n<p><strong>Terms of Service and Privacy Policy<\/strong><\/p>\n\n<p>Use of the hosted SearchUs service is governed by our <strong>Terms of Service<\/strong> and <strong>Privacy Policy<\/strong> on the SearchSaaS dashboard site:<\/p>\n\n<ul>\n<li><strong>Terms of Service:<\/strong> https:\/\/searchus.funnelwon.com\/tos\/<\/li>\n<li><strong>Privacy Policy:<\/strong> https:\/\/searchus.funnelwon.com\/privacy\/<\/li>\n<\/ul>\n\n<p>For retention, security, legal bases, subprocessors, and other details, see the Privacy Policy link above. That policy governs FunnelWon \/ SearchUs as the service provider; your site still needs its own policy where required. The Privacy Policy is also published at https:\/\/funnelwon.com\/privacy\/ for convenience.<\/p>\n\n<h3>Third-party libraries<\/h3>\n\n<p>The plugin bundles <strong>Driver.js<\/strong> (https:\/\/github.com\/kamranahmedse\/driver.js) under the <strong>MIT License<\/strong> for the in-admin setup walkthrough. Source is included under <code>admin\/vendor\/driver\/<\/code>.<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Upload the plugin folder to <code>\/wp-content\/plugins\/<\/code> (for example <code>searchus\/<\/code>) or install via Plugins \u2192 Add New.<\/li>\n<li>Activate the plugin. Complete <strong>free or paid license activation<\/strong> in SearchUs settings (register or paste an API key). The plugin creates a Search page; <strong>after activation<\/strong>, search and indexing use the SearchUs API as described in Privacy and External services. Until activation, visitor <code>?s=<\/code> search stays on WordPress\u2019s built-in search.<\/li>\n<li>In the WordPress admin sidebar, open <strong>SearchUs \u2013 Site Search for WordPress and WooCommerce<\/strong> to lock settings, run a full reindex, and configure SERP, ranking, and Smart 404.<\/li>\n<li>Run \"Full site reindex\" at least once so the index is built. After that, optional auto-crawl can keep it updated.<\/li>\n<\/ol>\n\n<p><strong>Before the first successful reindex:<\/strong> With license activation complete and SearchUs handling visitor search (the default), searches are sent to the SearchUs API. If nothing has been indexed yet, visitors often see <strong>no results<\/strong>\u2014the plugin does <strong>not<\/strong> switch back to WordPress\u2019s built-in search in that mode. Run a full reindex as soon as setup allows. If you need core WordPress search until indexing finishes, choose <strong>Use default WordPress results page<\/strong> under SERP \u2192 Layout in settings.<\/p>\n\n<!--section=faq-->\n<dl>\n<dt id=\"do%20i%20need%20to%20reindex%3F\"><h3>Do I need to reindex?<\/h3><\/dt>\n<dd><p>Yes. Run a full site reindex from the plugin admin (Plugin Settings \u2192 Reindex \/ crawl area) after activation and when you add or change a lot of content. Optional auto-crawl can then keep the index updated when you publish or update posts\/pages.<\/p>\n\n<p><strong>After your license is activated<\/strong>, visitor search uses the SearchUs API (unless you chose \u201cdefault WordPress results\u201d under SERP \u2192 Layout). <strong>Until the first full reindex has completed<\/strong>, many sites will show <strong>empty search results<\/strong>\u2014that is expected, not a fallback to WordPress\u2019s native search. Complete a full reindex to populate the service index; use the default WordPress results option temporarily if you need the theme\u2019s normal search while indexing is still running.<\/p><\/dd>\n<dt id=\"can%20i%20use%20my%20theme%27s%20search%20template%3F\"><h3>Can I use my theme's search template?<\/h3><\/dt>\n<dd><p>Yes. Under SERP \u2192 Layout, choose \"Use default WordPress results page.\" <strong>After license activation<\/strong>, we still supply the results and ranking via the API; your theme controls the layout. Attribution may appear on the free tier per your license and API response.<\/p><\/dd>\n<dt id=\"what%20is%20smart%20404%3F\"><h3>What is Smart 404?<\/h3><\/dt>\n<dd><p>When a visitor hits a 404, the plugin can show \"similar\" results derived from the URL (e.g. missing product or page). Enable it under Smart 404s in settings.<\/p><\/dd>\n<dt id=\"does%20it%20work%20with%20woocommerce%3F\"><h3>Does it work with WooCommerce?<\/h3><\/dt>\n<dd><p>Yes. Enable the product post type for indexing under Crawl \u2192 Inclusion. Product caps and ranking multipliers are under Ranking. On the SearchUs SERP template, <strong>Ecommerce \u2192 WooCommerce<\/strong> controls Buy Now destination (checkout, cart, or off). Simple in-stock products show Buy Now. Variable products show option pickers (color, size, and other attributes) and Buy Now for the selected in-stock variation. Grouped products link via the product title. External\/affiliate products can show a vendor buy link. Buy Now requires published WooCommerce Cart and\/or Checkout pages. Stock and price refresh when results load. The same screen holds <strong>Variant Option Aliases<\/strong> (YAML map like Intent synonyms) so query language such as \u201cextra extra large\u201d maps to your attribute term slugs for variation preselect.<\/p><\/dd>\n<dt id=\"what%20data%20is%20sent%20to%20searchus%20by%20funnelwon%3F\"><h3>What data is sent to SearchUs by FunnelWon?<\/h3><\/dt>\n<dd><p>See <strong>Privacy<\/strong> and <strong>External services<\/strong>. In short: your <strong>site URL<\/strong>, <strong>API key<\/strong> (if any), <strong>plugin version<\/strong>, and data required for <strong>indexing\/search\/API<\/strong> are transmitted <strong>after activation<\/strong> as part of the service. <strong>Theme, hosting, and plugin lists<\/strong> are not sent automatically for support\u2014you may be asked to provide those manually if you open a ticket. Junk scanner queries are blocked locally and are not sent.<\/p><\/dd>\n<dt id=\"what%20are%20the%20minimum%20requirements%3F\"><h3>What are the minimum requirements?<\/h3><\/dt>\n<dd><ul>\n<li>WordPress 5.9 or higher (see header above for the \u201cTested up to\u201d value).<\/li>\n<li>PHP 7.4 or higher (see header above).<\/li>\n<li>Outbound <strong>HTTPS<\/strong> connectivity from your server to FunnelWon\u2019s SearchUs API for <strong>license activation<\/strong>, <strong>indexing<\/strong>, and <strong>visitor search<\/strong> once setup is complete.<\/li>\n<li>A modern hosting stack; <code>curl<\/code> or equivalent is used via WordPress HTTP APIs.<\/li>\n<\/ul>\n\n<p>MySQL\/MariaDB versions follow WordPress core requirements for your WordPress version.<\/p><\/dd>\n<dt id=\"what%20does%20%E2%80%9Ctested%20up%20to%E2%80%9D%20mean%3F\"><h3>What does \u201cTested up to\u201d mean?<\/h3><\/dt>\n<dd><p>The <strong>Tested up to<\/strong> value in the plugin header is the latest WordPress release the authors have smoke-tested with this plugin version. Use a current, supported WordPress version on your site.<\/p><\/dd>\n<dt id=\"why%20do%20i%20need%20license%20activation%20for%20search%20and%20indexing%3F\"><h3>Why do I need license activation for search and indexing?<\/h3><\/dt>\n<dd><p>SearchUs is a <strong>hosted search service<\/strong>: indexing and ranked results run against FunnelWon\u2019s API after a <strong>free or paid<\/strong> API key is stored. Until you finish activation, front-end search requests use WordPress\u2019s default search so visitors are not routed through SearchUs for <code>?s=<\/code> results.<\/p><\/dd>\n<dt id=\"is%20this%20plugin%20a%20fork%20of%20another%20search%20plugin%3F\"><h3>Is this plugin a fork of another search plugin?<\/h3><\/dt>\n<dd><p>No. <strong>SearchUs by FunnelWon<\/strong> is developed and maintained by FunnelWon. It is not a fork of any plugin or other third-party search plugins.<\/p><\/dd>\n<dt id=\"do%20you%20offer%20paid%20plans%3F%20what%20changes%20when%20i%20upgrade%3F\"><h3>Do you offer paid plans? What changes when I upgrade?<\/h3><\/dt>\n<dd><p>This is <strong>one plugin<\/strong> with the same settings UI on every plan. Upgrading means a <strong>FunnelWon \/ SearchUs license<\/strong> with higher <strong>service quotas<\/strong>, for example:<\/p>\n\n<ul>\n<li>More <strong>indexed URLs<\/strong> (index cap on the API).<\/li>\n<li>Higher <strong>monthly search queries<\/strong> (and, on paid production sites, optional metered overage per your subscription).<\/li>\n<li>More frequent <strong>full reindexes<\/strong> when your plan allows (the service returns allowance and retry timing in usage\/API responses\u2014not hidden timers in the plugin).<\/li>\n<li><strong>Attribution removal<\/strong> on results where your paid license and API response allow it.<\/li>\n<\/ul>\n\n<p>Ranking weights, intent, media extraction, SERP injections, reordering, and multi-user mode remain available in the plugin; the service applies your saved configuration when processing search and indexing. For plan comparison and pricing, see https:\/\/searchus.funnelwon.com\/<\/p><\/dd>\n<dt id=\"where%20can%20i%20find%20documentation%3F\"><h3>Where can I find documentation?<\/h3><\/dt>\n<dd><p>Product and setup information are published on <strong>FunnelWon<\/strong> (see the Author link above). The in-plugin <strong>FAQ<\/strong> panel and settings descriptions explain individual controls. For WordPress.org installs, use the plugin\u2019s support forum for general questions.<\/p><\/dd>\n<dt id=\"will%20it%20work%20with%20my%20theme%3F\"><h3>Will it work with my theme?<\/h3><\/dt>\n<dd><p>In most cases, yes. <strong>After license activation<\/strong>, the plugin adds a dedicated search page template and can redirect normal WordPress search (<code>?s=<\/code>) to it, or you can use <strong>default WordPress search results<\/strong> so your theme\u2019s search template wraps our results (see SERP \u2192 Layout). You may need minor CSS adjustments so the search page matches your theme. Themes that heavily override search or use unusual routing should be tested after installation.<\/p><\/dd>\n<dt id=\"where%20can%20i%20report%20bugs%2C%20request%20features%2C%20or%20get%20help%3F\"><h3>Where can I report bugs, request features, or get help?<\/h3><\/dt>\n<dd><ul>\n<li><strong>WordPress.org users:<\/strong> use the plugin\u2019s <strong>Support<\/strong> tab \/ forum on this listing.<\/li>\n<li><strong>License customers:<\/strong> use the support channel provided with your SearchUs by FunnelWon subscription (see https:\/\/searchus.funnelwon.com).<\/li>\n<\/ul>\n\n<p>When reporting issues, include WordPress version, PHP version, active theme, and (if asked) a paste of <strong>Tools \u2192 Site Health \u2192 Info<\/strong>\u2014see the Privacy section.<\/p><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<h4>2.0.7<\/h4>\n\n<ul>\n<li>Improved phrase synonyms: multi-word queries like \"search ads\" match the longest synonym phrase (e.g. ppc) instead of a single ambiguous token (e.g. search \u2192 seo).<\/li>\n<\/ul>\n\n<h4>2.0.4<\/h4>\n\n<ul>\n<li>Show the API plan-cap reindex summary dialog before reload, with Crawl Inclusion and upgrade actions.<\/li>\n<\/ul>\n\n<h4>2.0.3<\/h4>\n\n<ul>\n<li>Let the SearchUs API apply plan URL limits to full reindexes, then show how many eligible URLs were stored or excluded by the API plan cap.<\/li>\n<li>Add Crawl &gt; Inclusion guidance when an index reaches its API plan limit, so site owners can prioritize content and media without plugin-side plan enforcement.<\/li>\n<\/ul>\n\n<h4>2.0.2<\/h4>\n\n<ul>\n<li>Fix mobile SERP product\/image grids overflowing the viewport (fixed 225px tracks). Tiles now use fluid two-column columns that fit theme content width without horizontal scrolling.<\/li>\n<\/ul>\n\n<h4>2.0.1<\/h4>\n\n<ul>\n<li>Admin sidebar menu label shortened to \u201cSearchUs\u201d (full plugin name unchanged on the Plugins screen and WordPress.org).<\/li>\n<\/ul>\n\n<h4>2.0.0<\/h4>\n\n<ul>\n<li>Search Embeds (SERP \u2192 Search Embeds): create named shortcodes that limit search to pages, posts, products (optional WooCommerce categories), and\/or media types that match your crawl settings (Images, PDFs, Documents, videos, audio, embeds). Custom name, shortcode ID, placeholder, and button label; paste into pages, posts, or builders via [searchus_search scope=\"your-id\"].<\/li>\n<li>Scoped results page: embeds send visitors to SearchUs results with clear \u201csearch is limited to\u2026\u201d context and matching tabs\/filters for that scope (products-only, media-only, etc.).<\/li>\n<li>Product filter drawer (WooCommerce): on Shopping tab or products-only embeds, open Filters for categories, min\/max price ($0 allowed; high ceiling for expensive catalogs), brands (store brands + brand attributes when both exist), color, and size systems (clothing, footwear, hats) so shoe sizes aren\u2019t mixed with apparel.<\/li>\n<li>Shareable filter URLs: applied filters stay in the address bar and survive pagination; reopening the drawer keeps your current selections.<\/li>\n<li>Natural-language price in the query: phrases like \u201cunder $100\u201d or \u201cbetween 200 and 500\u201d are recognized, cleaned from the keyword query, and applied as product price filters (with chips on the results for active constraints).<\/li>\n<li>Variable products on SERP: color\/size (and related) pickers with in-stock awareness and two-way filtering, plus Buy Now for the selected variation.<\/li>\n<li>Ecommerce variant option aliases (separate from intent synonyms): map shopper language (e.g. sizes\/colors people type) to real WooCommerce variation options; starter pack included and editable under Ecommerce.<\/li>\n<li>Intent synonyms vs. catalog aliases cleanly split: Suggest Assist helps with either store intent synonyms or variation aliases\u2014not a single mixed map\u2014so language expansion and variation matching stay distinct.<\/li>\n<li>AI Assist for Intent synonyms and Ecommerce variant aliases: with one click, Suggest can draft shopper-language mappings for you\u2014so searches like \u201csneakers\u201d or \u201cXXL\u201d connect to the right content and variation options without hand-building every alias. Free licensed sites include a monthly assist budget; paid plans are unlimited.<\/li>\n<\/ul>\n\n<h4>1.0.4<\/h4>\n\n<ul>\n<li>SERP Background default is solid white; optional \u201cTransparent \/ match theme background\u201d shows the theme behind the results.<\/li>\n<\/ul>\n\n<h4>1.0.3<\/h4>\n\n<ul>\n<li>Update Shopping tab result tiles to match Images, Videos, and other grid tile styling (card borders, rounded corners, square thumbs).<\/li>\n<\/ul>\n\n<h4>1.0.2<\/h4>\n\n<ul>\n<li>Updated plugin description on WordPress.org.<\/li>\n<\/ul>\n\n<h4>1.0.1<\/h4>\n\n<ul>\n<li>Fix license activation on hosted staging\/preview URLs (Kinsta, WP.com staging, and similar).<\/li>\n<li>Fix activation verify URL on sites using plain permalinks (uses \/fw-si-v-{token}\/ path instead of ?page_id=).<\/li>\n<\/ul>\n\n<h4>1.0.0<\/h4>\n\n<ul>\n<li>Initial release: SERP page template, redirect, Smart 404, intent\/synonyms, ranking and media controls in admin, \"Did you mean?\", crawl\/reindex, URL and DOM exclusions, settings lock, optional local rate limits and junk-query guard. PHP 7.4+ supported via polyfills.<\/li>\n<li>WordPress.org compliance: all plugin settings available on every plan; plan limits (indexed URLs, monthly queries, reindex allowance, attribution) enforced by the SearchUs API only. Readme and External services documentation updated accordingly.<\/li>\n<\/ul>","raw_excerpt":"Site search for WordPress and WooCommerce \u2014 ranked results, product filters, Buy Now from search, and Smart 404 recovery.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/arg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/301072","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/arg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/arg.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/arg.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=301072"}],"author":[{"embeddable":true,"href":"https:\/\/arg.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/funnelwon"}],"wp:attachment":[{"href":"https:\/\/arg.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=301072"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/arg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=301072"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/arg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=301072"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/arg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=301072"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/arg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=301072"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/arg.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=301072"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}