Docs Redirects
Documentation

Redirects

Every fix Relink applies installs a real, native Shopify URL redirect — the same kind you’d create by hand in Online Store → Navigation → URL Redirects. There is no Relink-side proxy layer.

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 suggestion you applied.

Shopify admin · URL Redirects
/products/ceramic-mug-blue-old
→ /products/ceramic-mug-cobalt
Active
/collections/black-friday-2023
→ /collections/sale
Active
/pages/winter-2023-sale
→ /pages/winter-sale
Active

The Redirects tab

Inside Relink, open History → Redirects. The tab lists every redirect Relink added. It’s the same data as in Shopify admin, filtered to just Relink’s redirects, with extra context like which pages carried the link and when the redirect was added. From each row you can Change the new page or Undo fix.

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 Remove ones no longer needed button on the History → Redirects tab checks every redirect Relink added. It removes the ones whose From address works again on its own (it loads without following the redirect).

When this fires

This is the reason checkLink uses redirect: "follow" in the scanner. After a fix is applied, the original URL "becomes healthy" because of Relink’s own redirect — that’s how stale detection knows the source URL has been re-published.

Missing redirects

Occasionally a fix shows Redirect missing. This means Relink changed the link on your pages (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.
History · Fixes · Redirect missing
/products/old-knit-scarf
Changed on 3 pages · Redirect failed: duplicate exists
Redirect missing

A missing redirect is safe for your storefront — visitors browsing it 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 added. To add it, open History → Redirects, click Change on that row and save a page. You can also undo the fix and apply it again.

Reverting a fix

You can undo every fix that changed a link to a new page. Use Undo fix on the History → Fixes tab (one page) or the History → Redirects tab (every page with that link). You can’t undo a removal (see below). Undo:

  • Puts the old address back in the page.
  • Removes the Shopify URL redirect Relink added, once no other fixed page still uses it.
  • Puts the broken link back on your dashboard so you can fix it again.

If a page was edited after the fix, part of it may not go back. Relink tells you when that happens, so you can check the page in Shopify.

Edge case

You can’t undo a removal. When Relink removes a link, the words stay and only the link goes, so there’s no new address to swap back. Re-add the link yourself in Shopify admin.

CSV export

The Export menu on the dashboard has a Fix history (CSV) option. It produces a CSV with one row per fixed link, including the redirect Relink added:

relink-fix-history.csv
Fixed at,Status,Resource type,Resource title,Resource ID,Field,Original URL,Replacement URL,Suggestion source,Confidence,Redirect installed,Redirect error
2026-05-12T08:14Z,FIXED,Product,Cobalt Mug,gid://shopify/Product/1,body_html,/products/old-mug,/products/cobalt-mug,AI,0.96,true,
2026-05-12T08:14Z,FIXED,Article,Gift guide,gid://shopify/Article/7,body_html,/collections/bf-2023,/collections/sale,HEURISTIC,1,true,
2026-05-14T12:31Z,FIXED_PARTIAL,Page,Winter,gid://shopify/Page/3,body_html,/products/winter-2022,/products/winter,AI,0.81,false,Redirect already exists

Need a hand?

Email shopify-support@tryrelink.app — average reply under one business day.

Install Relink