meilisearch / meilisearch/documentation

Add missing redirect: /learn/filtering_and_sorting/facets_vs_filters returns 404

Open Beginner friendly
#3,673 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

fix/improvement SEO
Dominant language
MDX
Stars
174
Forks
276
Avg merge
2d 1h
Merged PRs (30d)
6

Description

Follow-up to #3672.

A live sweep of all 121 pre-restructure /learn/* and /guides/* URLs (as of the 2026-02-14 tree) found exactly one URL with no redirect:

https://www.meilisearch.com/docs/learn/filtering_and_sorting/facets_vs_filters returns a hard 404. It is the only old path absent from config/redirects.json; the other 120 all 308-redirect to a live page.

Suggested fix: add a redirect to the page that now covers facets vs filters (likely under capabilities/filtering_and_sorting/ or the faceted search page in the new IA).

GSC shows no recorded impressions for this URL in 2026, so the traffic impact is minimal, but it is the last gap keeping the old URL space from being fully covered.

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start with config/redirects.json and compare the missing legacy path with the existing redirects from the URL sweep. Find the current documentation page covering facets versus filters, add the redirect, and verify that the old URL resolves to that live page instead of returning 404.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Bug
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Active
Clarity
Mostly clear
Newbie friendliness
82/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.