AddThisFeature

No-Results Recovery

Turn an empty search into a next step instead of a dead end.

simple Search & Discovery

What it adds

A zero-result search state that says which part of the query is at fault and offers a concrete way to get results.

What your agent is told to do

5
  1. 1

    Separate the causes: no matches, a failed request, and results filtered away by permissions all look identical to the user and need different copy.

  2. 2

    When filters are active, list them and let the user drop them individually — and name the one that eliminated the most results.

  3. 3

    Rerun the query in a relaxed form behind the scenes (fewer terms, or without the narrowest filter) and offer that as a suggestion with its real count.

  4. 4

    Suggest a spelling correction only when you have a real candidate from the index, phrased as a question the user can accept.

  5. 5

    Do NOT show approximate or unrelated results as if they matched. A wrong answer presented confidently is worse than an honest empty state.

Edge cases it handles

6
  • Suggested counts must respect the user's permissions, or the number itself reveals records they cannot see.
  • A 'did you mean' must not suggest a term that also returns nothing.
  • Never hint that a hidden record exists — no 'one result in a workspace you cannot access'.
  • Log zero-result queries with their filters. That log is the highest-value backlog you have for search and for content gaps.
  • Do not log query text if the privacy rules for search history forbid it; log the shape instead.
  • A search that returns nothing because the account has no data at all is an onboarding problem, not a search problem — send them to the empty state.

Definition of done

8
  • No matches, request failure, and permission-filtered results have distinct states and copy.
  • Active filters are listed and individually removable from the empty state.
  • A broadened query is offered with its actual result count.
  • Spelling suggestions come from the index and never lead to another empty result.
  • No suggestion or count reveals the existence of a hidden record.
  • Zero-result queries are recorded for review.
  • The feature matches the existing design system.
  • No existing functionality is broken.

Related features

How it works

  1. 1

    Copy the link

    Grab the Markdown instruction URL for this feature.

  2. 2

    Give it to your AI

    Paste it into Claude Code, Cursor, v0, Lovable — whatever you build with.

  3. 3

    It inspects, then implements

    Your agent reads your existing app first, then adds the feature to fit it.

Works with your stack

These instructions are written to adapt. They tell the agent to detect your framework, match your existing design system, and reuse what you already have — rather than assuming a particular stack.

Need it tighter than that? Customize the feature and tell it exactly what you're running.