Redirects

Native, not middleware

A common question: "If I uninstall Relink, do my redirects break?" No. Every redirect lives in Shopify's own URL redirect table. Relink writes to it via the Admin API and that's it.

That has a few useful consequences:

• Redirects keep working if you uninstall Relink.
• You can see and edit every Relink-created redirect in Shopify admin.
• They apply to every storefront — Liquid theme, Hydrogen, custom Storefront API.
• They count toward Shopify's per-store redirect limit (currently 100,000), just like manual ones.

What it looks like in Shopify admin

In your Shopify admin under Online Store → Navigation → URL Redirects, every Relink-created redirect appears as a normal row. The From URL is the broken slug; the To URL is the AI's chosen replacement.

The Redirects page

Inside Relink, the /app/redirects page lists every redirect this app installed — every BrokenLink with a non-null redirectId. It's the same data as in Shopify admin, but filtered to just Relink's footprint, with extra context like which source pages used the link and when the redirect was created.

Stale redirects

A redirect is stale when it points to a target that's no longer needed — for example, the original broken URL has come back to life because you re-published the product, or you applied a manual fix that updated the source HTML without a redirect.

The Clean up stale button on the Redirects page audits every Relink-installed redirect and deletes the ones whose From URL is now reachable (returns 2xx without following the redirect).

Partial fixes

Occasionally a fix gets the FIXED_PARTIAL status. This means Relink successfully patched the source HTML (so internal navigation works) but the Shopify URL redirect didn't save. Causes:

• You've hit Shopify's redirect cap.
• A duplicate redirect already exists with the same From URL.
• A transient Admin API error.

A partial fix is safe — visitors browsing your storefront see the new link. The only people affected are external visitors who hit the old URL directly (e.g. from a Google search cache or a backlink). They'll see a 404 until the redirect is retried, which happens automatically on the next scan or when you click Retry redirect in Fix history.

Reverting a fix

Every fix is one-click reversible from the /app/history page. Undo:

• Restores the original anchor in every source resource.
• Deletes the Shopify URL redirect.
• Re-flags the row as OPEN so it shows up in your queue again.

CSV export

The Export button on the Redirects page produces a CSV with one row per redirect: