AI suggestions

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 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 suggest 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.

AI  AI

The model picked a candidate from your live pages and Relink validated the choice exists. Used when the page names didn’t match — i.e. when the answer requires semantic judgment, not string matching.

Heuristic  Heuristic

A suggestion made without AI. 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.

Fallback page

Business plan. In Redirect all mode, Relink sends every broken link to the fallback page you set in Settings, without asking the AI. Useful for stores where unrecoverable 404s should land on a single hub page. In other modes the fallback page is not a suggestion.

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 fit. Applying it removes the link. The words stay. Only the link goes. No redirect is added. You can’t undo a removal.

Real before-and-after examples

Reviewing a suggestion

Click a broken link’s address on the dashboard to open the side drawer. You’ll see:

• The original broken URL with the source page(s) where it appears.
• The suggestion with its source pill (AI / Heuristic / etc.).
• An autocomplete to pick a different live page if you disagree.
• Actions to apply the suggestion (Apply to this page), ignore the link, or remove it.

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 AI-generated suggestions per month. After that, Relink falls back to suggestions from page names until the counter resets.
• 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.