Route Not Working
Overview
If a URL resolves but the wrong page or layout renders, the issue is almost always in route configuration.
This page covers the checks that match how Marketplace chooses which route and layout to use.
Symptoms this page covers
- The URL loads, but it shows the wrong content.
- The URL loads, but it shows the wrong layout type.
- A vanity inventory URL loads, but it does not apply the intended filter.
Causes and fixes
Two routes claim the same path
If two route entries claim the same path, the first match wins.
Fix:
- In Sanity Studio, open Routes and search for the path.
- Remove the duplicate path entry so only one route claims the URL.
The wrong layout type is assigned
The Layout type controls which frontend experience renders.
Examples:
- contentBlockDefault renders CMS content sections
- search and searchWithSideFilter render the Search Results Page (SRP)
- productAuto and productRV render a Vehicle Detail Page (VDP)
Fix:
- Open the Route document.
- Update the Layout field to the correct layout type for the URL.
The linked Page has no content blocks
A contentBlockDefault route can render a valid page with no visible content if the linked Page document has no content blocks.
Fix:
- Open the linked Page document in Sanity Studio.
- Add content blocks and publish.
Vanity filter segments do not match index attribute values
Vanity inventory paths rely on exact matching against inventory attributes in Meilisearch.
Example:
- /shop/toyota relies on a match to the make attribute value.
If the index value is stored differently, the vanity segment will not apply the intended filter.
Fix:
- Open the live SRP and review the filter panel values to see canonical attribute values.
- Update the vanity segment in the route path to match the attribute value exactly.
The query_string field is misconfigured
Routes can include a pre-applied query string for default filtering.
If query_string is blank or incorrect, the expected default filters do not apply.
Fix:
- Open the Route document.
- Open the specific path entry.
- Verify the query_string value and correct it.