Docs AI suggestions
Documentation

AI suggestions

Every broken link gets exactly one suggestion. This page explains where it came from, why it was chosen, and when to trust it.

How a suggestion is generated

When the scan finds a broken URL, Relink builds a shortlist of candidate live pages from your store, then runs them through a single LLM call (Gemini 2.5 Flash via OpenRouter). The model sees:

  • The original broken URL slug.
  • Anchor text and surrounding HTML where the link appears.
  • The page type — product, collection, page, or article.
  • The candidate shortlist with titles, descriptions, and tags.

The model is required to pick from the shortlist (or return "REMOVE" if nothing fits), so Relink can never recommend a URL that doesn't exist in your store.

Suggestion sources

Every suggestion is tagged with a source that tells you how it was chosen. This is shown as a pill in the drawer and in the dashboard table.

Suggestion source badges
AI suggestion
Picked by the model from your live pages.
AI
Heuristic match
Exact handle / title hit — no AI call needed.
Heuristic
Global redirect
Business plan only — your fallback URL.
Global
Manual pick
You chose this from the drawer's autocomplete.
Manual
Remove link
No good match — the anchor will be removed.
Remove

AI  AI

The model picked a candidate from your live pages and Relink validated the choice exists. Used when no exact handle match was found — i.e. when the answer requires semantic judgment, not string matching.

Heuristic  Heuristic

A non-AI match. Used when:

  • The broken slug exists on a different resource type (e.g. /products/foo dead, /pages/foo live).
  • An exact title match exists.
  • Your AI quota is exhausted (Free plan) — Relink falls back to handle/title matching rather than block the fix.

Global  Global redirect

Business plan. If you've configured a Global Redirect URL in Settings, broken links that the AI can't match get redirected there instead of being left open. Useful for stores where unrecoverable 404s should land on a single hub page.

Manual  Manual

You overrode the AI's pick using the drawer's autocomplete. Manual picks are tracked separately so future scans don't overwrite them.

Remove  Remove

The model returned "REMOVE" because nothing in your store is a reasonable match. Applying this fix strips the anchor tag from the source HTML and leaves the surrounding text in place — no redirect is created.

Real before-and-after examples

Before · AI
/products/aqua-throw-blanket-discontinued
Anchor text on the homepage: "shop the aqua throw"
→
After
/products/turquoise-throw-blanket
Matched on colour family + product type, even though the slug shares no tokens.
Before · Heuristic
/products/about-us
A merchant linked to /products/about-us by mistake.
→
After
/pages/about-us
Same handle exists as a Page — no AI call needed.
Before · Remove
/pages/team-photo-shoot-bts-2021
One-off campaign page from 2021 referenced in a blog footer. Nothing similar exists today.
→
After
(anchor removed)
The anchor tag is stripped; surrounding sentence is preserved.

Reviewing a suggestion

Click any row in the dashboard to open the side drawer. You'll see:

  • The original broken URL with the source page(s) where it appears.
  • The AI's chosen replacement with the source pill (AI / Heuristic / etc.).
  • An autocomplete to pick a different live page if you disagree.
  • An Apply fix, Ignore, and Remove link action.
Tip

If a URL appears on multiple pages, Relink groups them and applies the same fix to all of them in one transaction — and creates the Shopify redirect exactly once.

Overriding the AI

Type into the drawer's autocomplete to search every live product, page, article, and collection. Pick one and the source flips to Manual. Your override sticks — future scans won't replace it.

AI quotas

  • Free — 5 lifetime AI-generated suggestions. After that, Relink falls back to heuristic matches for new broken links.
  • Pro & Business — unlimited AI suggestions.

The 5-suggestion limit on Free is intentionally low to make the AI quality obvious without burning model credits. Most stores exhaust it on the first scan.

Need a hand?

Email laurencetuchin@gmail.com — average reply under one business day.

Install Relink →