Algolia Search Results Irrelevant or Wrong Order

How to fix it

Try these in order — the most common fix is first.

1. 1. Order searchable attributes by importance

   Copy steps
   1. Open Configuration > Searchable attributes
   2. Put the most important attribute (title, name) first
   3. Avoid giving many attributes the same priority; Algolia treats equal-priority attributes as one group, which can give unexpected results
   Did this fix it? Yes No

2. 2. Add custom ranking

   Copy steps
   1. Go to Configuration > Ranking and Sorting > Custom ranking
   2. Add a numeric attribute such as popularity or sales count in descending order
   Did this fix it? Yes No

3. 3. Inspect why a record ranks where it does

   Copy steps
   1. Use the dashboard Search > Index browser and enable ranking info (getRankingInfo) to see the criteria
   2. Check Rules and Synonyms for entries that pin or reorder results
   Did this fix it? Yes No

Symptoms

The best result is not first, results look random, or items that should match rank below weak matches.

Why it happens

• searchableAttributes order and priority are not set, or several attributes share the same priority
• No custom ranking (popularity, sales, rating) to break ties
• Records have sparse or low-quality attributes
• Synonyms or typo tolerance matching too loosely
• Rules or pinned results overriding the ranking

This guide also covers

• algolia relevance not working
• algolia wrong results order
• algolia ranking problems

Other Algolia errors

• Algolia Search Returns No Results
• Algolia 429 Too Many Requests Error
• Algolia Record Is Too Big Error
• Algolia Record Quota Exceeded or Limit Reached
• Algolia Invalid Application ID or API Key (403)
• Algolia Updates Not Showing in Search Results
• Algolia Search Slow or High Latency
• Algolia Crawler Not Indexing Records