Consult the following checklist to ensure youâre following best practices before going live.
Youâve defined your searchable attributes
For better relevance and performance, select attributes that are useful for search as your searchable attributes. You can then order your attributes based on the priority or relevance to search.
Youâve set most of your searchable attributes as unordered
You should define most of your attributes as unordered, as this ensures that the position of a word within the attribute doesnât affect the ranking.
Youâve set up your custom ranking with business metrics
Make sure youâve added business metrics to your , such as most-liked, most-watched, best-sold, and similar.
These metrics enable you to customize your ranking.
Custom ranking is second only to searchable attributes in importance, as it gives you direct control over every set of results and is critical to ranking and relevance.
You havenât changed the default ranking formula unless necessary
Unless you have explicit reasons not to, you should use the default ranking formula. Itâs usually best to set it back to its default before going live.
You havenât changed Algoliaâs engine defaults unless necessary
You should keep the default settings unless you have no alternative. These are some important defaults you shouldnât change unless necessary:
If you change any of the defaultsâfor testing purposes or to solve a particular problemâmake sure to set them back to their original values unless those changes are necessary.
Youâre not revealing any sensitive information
By default, Algolia includes all attributes in the JSON response, even if you donât display them in your user interface.
To exclude some attributes from the response,
set them as unretrievableAttributes.
Youâve added all necessary synonyms
Itâs best to think about synonyms right away. Every index has alternative words for the same meaning. For example, you may want to treat âfilmâ and âmovieâ as equivalents. Synonyms also help you avoid queries with no results.
Youâre using the common language or languages of your users
Set the language of your search solution to the most common language or languages of your users.
Youâre treating singulars and plurals as the same
Make sure to treat plurals and singulars equivalently. For example, you may want the engine to consider âfilmâ and âfilmsâ as being equivalent for search purposes.
Youâre removing stop words
Stop words are small common words like âofâ and âtheâ. If these words appear in queries, they can introduce irrelevant results. Tell the search engine to ignore stop words.
Youâve tested the top 10 queries
Test your top 10 queries and other analytics metrics to see if youâre satisfied with the results.
Youâve checked for insufficient results
Check to see if your search is returning no or unsatisfying results.
Youâre using highlighting in your results
Make sure youâre highlighting matched text in your results.
Youâve implemented instant search results with facets
Make sure youâre displaying full search results instantly with every keystroke. No âEnterâ key is required. Set up helpful facets on your frontend.
Youâve hidden your admin key
Donât use your admin API key in your frontend code.
Youâve followed the security best practices
Keep the security best practices in mind.
You havenât hard-coded any API keys in your mobile app
Make sure your mobile applications are using API keys appropriately.
Youâre using the most recent versions of the software
Ensure you use the most recent versions of all software in Algoliaâs ecosystem.
Youâve implemented and validated Click and Conversion events
To make the most of Algoliaâs powerful features and analyze your search relevancy, send events and check whether you have sent them correctly.
When sending events, youâre using a pseudonymous or anonymous user token
All events require a userToken that relates a user profile to an event. Donât include personally identifiable information in a userToken.
Ensure that you get and send the appropriate pseudonymous or anonymous token.
Youâve optimized search request usage
The number of calls made to Algolia per search request affects your billing, so make sure that you have optimized your Algolia implementation. Last modified on February 20, 2026
