Troubleshooting

"Redirect missing" warning

A row shows the Redirect missing badge on History → Fixes or History → Redirects.

What happened — Relink changed the link on your pages (so your storefront links work) but couldn’t add the Shopify URL redirect for the old address. Visitors from Google, other websites or bookmarks still see "page not found" there.

Common causes:

• A duplicate redirect already exists with the same From URL — maybe you created one manually.
• You’ve hit Shopify’s per-store redirect cap (100,000).
• Transient Admin API error during the fix.

1. Add the redirectOpen History → Redirects, click Change on that row and save a page. You can also undo the fix and apply it again.
2. If duplicate, resolve itOpen Shopify admin → Online Store → Navigation → URL Redirects and decide which redirect should win.
3. If at cap, clean up staleUse Remove ones no longer needed on History → Redirects to remove redirects whose old address works again.

"AI quota exhausted" on Free

Free plan: 5 AI-generated suggestions per month. After that, Relink falls back to suggestions from page names until the counter resets next month.

Fix — upgrade to Pro for unlimited AI. Until then, suggestions from page names (same address ending, same title) still work, and you can still pick any live page manually from the drawer’s autocomplete.

Scan stuck in queue

Scan has been "Waiting" for more than a minute.

Common causes:

• The background worker process is down or restarting (we monitor and auto-recover, but it can take a few minutes during deploys).
• A previous scan didn’t release its per-shop lock — usually self-heals within 60 seconds.
• The scan queue is full — extremely rare for a single store.

1. Wait 60 secondsMost stuck states resolve themselves.
2. Refresh the pageThe dashboard polls scan status; a refresh re-syncs.
3. If still stuck after 5 minutesEmail shopify-support@tryrelink.app with your shop domain — we can clear the lock manually.

"Scope update required" prompt

You see a banner asking you to re-approve permissions.

What happened — Relink added a new API scope (often because Shopify deprecated an older one). Approve it and the banner will disappear. Approving is safe — every requested scope is documented in Settings → Permissions.

Scan finished, no broken links found

A clean scan is actually the goal — but if you’re sure your store has broken links and Relink missed them:

• Resources cap — on Free plan, only the first 100 resources are scanned. Upgrade to Pro for 2,500, or Business for 50,000.
• External links — Relink only fixes internal store URLs. Links pointing to other domains are out of scope by design.
• Theme code — broken links hard-coded in Liquid templates aren’t read by Relink; only content (products, pages, blogs, collections) is scanned.

AI picked a weird suggestion

The AI’s choice is consistently wrong for one of your broken URLs.

1. Open the drawerClick the broken link’s address on the dashboard.
2. Type the correct URLUse the autocomplete to search every live page.
3. Use this pageYour manual pick is logged as Manual and won’t be overwritten by future scans.

Redirect loop after applying a fix

Visiting a fixed URL sends the browser into a redirect chain.

Cause — usually a pre-existing manual Shopify redirect that now conflicts with Relink’s. For example:

• Old manual redirect: /products/a → /products/b
• Relink-created: /products/b → /products/c
• Result: /products/a → /products/b → /products/c (a chain — still works, but slow).

Open Shopify admin → URL Redirects and either delete the obsolete first hop, or update it to point straight at the final destination.

Undo didn’t restore my link

You can’t undo a removal. When Relink removes a link, the words stay and only the link goes, so History shows Can’t undo on that row. Re-add the link by editing the page in Shopify admin.

For other fixes, Undo puts the old address back. If the page was edited after the fix, part of it may not go back. Relink tells you when that happens, so check the page in Shopify.

Daily scan didn’t fire

You set a daily scan hour but no scan ran.

• Store time zone — the hour is in your store’s time zone (set in Shopify admin → Settings → General). Stores in a half-hour time zone scan at :30.
• Check past scans — open History → Scans in the app menu. If the run started but failed, it shows as Failed.
• Free plan — the daily automatic scan is on Pro and Business only.

Still stuck?

Email shopify-support@tryrelink.app. Include your shop domain, the date and time of the scan (on History → Scans), and a description of what you saw vs what you expected. Average reply: under one business day.