Gatemi Product Search FAQ and Troubleshooting

The search field does not show on my shop page

Check, in order:

  1. Is automatic placement on? Free edition: Automatic placement on WooCommerce → Product Search. Full edition: Show the search field on shop and category pages.
  2. Does your theme fire woocommerce_before_shop_loop? Every theme built on WooCommerce's classic templates does. A block theme whose shop template is built from the Product Collection block may not. Place the [gatemi_product_search] shortcode (or, in the full edition, the Product Search block) in the template or on the page instead. Full edition: a developer can also move the automatic panel to a hook your template does fire, with gatemi_product_search_auto_hook.
  3. Is the page empty of products? The hook only fires when there are products to list.
  4. Does the page already hold the shortcode or a block? Then the automatic copy is skipped on purpose, so there are never two fields. On the shop archive that means the content of WooCommerce's shop page; a shortcode quoted in a product's description does not count.

Suggestions do not appear while I type

  • Type at least two characters and pause briefly.
  • Open your browser's developer tools and look at the network request to /wp-json/gatemi-ps-free/v1/suggest (free) or /wp-json/gatemi-ps/v1/suggest (full). A security plugin that blocks the REST API for visitors stops the suggestions; allow those routes. The form itself still works.
  • Full edition: check Suggest products while typing is on, and that the index has finished building (the Index card).

Does it search SKUs and attributes?

Free edition: no. It searches what WordPress' own product search covers — title, short description and description — and there is no setting that changes it.

Full edition: yes. SKUs, categories, tags, brands, attributes and variation SKUs and options are all searched, each switchable under Searching.

Why does a product not appear in suggestions?

It is not published, or its Catalog visibility is Hidden or Shop only. Both editions keep a product hidden from search out of the suggestions; a product set to Search results only is suggested. In the full edition, it may also not be indexed yet — see Waiting to be indexed.

Does it work with page caching and CDNs?

Yes. The form is the same for every visitor, the suggestion routes are plain GET requests with nothing visitor-specific, and in the full edition every filtered view is an ordinary URL. Nothing needs excluding from the cache.

Does it work with the Cart and Checkout blocks and with HPOS?

Yes. Both editions declare compatibility with both. The plugin does not touch the cart, the checkout or orders.

Full edition: do I have to rebuild the index?

No. Products are re-indexed automatically when they change. Changing any setting in the Searching group rebuilds the index by itself. Rebuild the index is there for starting over.

Full edition: search keeps working while the index rebuilds?

Yes. A rebuild replaces products one batch at a time, and searches run against the index as it stands.

Full edition: the index stays at "Waiting to be indexed"

The background worker runs through WordPress cron, which runs when the site gets visits. On a quiet site, press Process the queue now. If the screen warns that the indexer is not scheduled, save the settings once to schedule it again. A site with DISABLE_WP_CRON needs a real cron job calling wp-cron.php.

Full edition: which attribute filters appear automatically?

The attributes with Enable archives? ticked under Products → Attributes. Any attribute can still be placed by hand with the Product Filter: Attribute block or shortcode.

Full edition: filtering reloads the page instead of updating in place

The script needs to find the element that holds your product loop. The defaults cover WooCommerce's standard markup and the product blocks. For a theme with unusual markup, add its selector with gatemi_product_search_grid_selectors. A page reload is the fallback, so nothing breaks.

Full edition: is any visitor data stored?

Only with Record what shoppers search for on, and then only the term, the number of results, the time, and the user ID of a signed-in shopper. No IP addresses, no session identifiers. Rows older than 180 days are deleted daily.

Moving from the free edition to the full edition

Install and activate the full edition. The free edition stands down on its own; deactivate and delete it when you like. Settings are not shared (the free edition has only one), so check the full edition's defaults. Any [gatemi_product_search] shortcode you placed keeps working.

Uninstalling

Free edition: deleting the plugin removes its one option, gmpsrf_settings. It has no tables, cron events or meta.

Full edition: deactivating never deletes anything. Deleting the plugin always removes the licence and the scheduled events. It drops the four tables (index, products, queue, search log) and the plugin's options only when Delete all data when the plugin is deleted is on. On multisite this runs for every site.

Shopping Cart
Scroll to Top