Skip to main content

Documentation Index

Fetch the complete documentation index at: https://algolia.com/llms.txt

Use this file to discover all available pages before exploring further.

Sometimes, you might want to exclude specific queries from your analytics. These searches still return results, but they won’t show up in any of the metrics. To exclude searches from analytics, set the analytics search parameter to false.

​
Empty searches

Often, one of the top-ranked search queries in your analytics is <empty search>. Empty searches have two origins:
  • An initial with an empty to instantly show results before users start typing
  • Category pages are built with an empty query and an applied
In some cases, the empty search might not be relevant. For example:
  • You only show search results when users are actively searching
  • You have an absolute ordering of your search results, such as, a blog search that’s sorted by date

​
Exclude searches from your analytics

To exclude specific search queries from your analytics, set the analytics parameter to false. For example, to exclude empty queries from your analytics, create a custom search client and set analytics: false when the query is empty: 
import algoliasearch from "algoliasearch/lite";
import instantsearch from "instantsearch.js";

const algoliaClient = algoliasearch(
  "ALGOLIA_APPLICATION_ID",
  "ALGOLIA_API_KEY",
);

const searchClient = {
  ...algoliaClient,
  search(requests) {
    const newRequests = requests.map((request) => {
      // Test for empty string and change `analytics` request parameter to `false`
      if (!request.params.query || request.params.query.length === 0) {
        request.params.analytics = false;
      }
      return request;
    });

    return algoliaClient.search(newRequests);
  },
};

const search = instantsearch({
  indexName: "instant_search",
  searchClient,
});

search.addWidgets([
  /* ... */
]);

search.start();
To prevent sending empty queries altogether, turn off search on empty queries.
Last modified on March 12, 2026