1. Install Relink
Open the Relink listing on the Shopify App Store and click Add app. Shopify will ask you to approve the permissions Relink needs to read your products, pages, blog articles, and URL redirects.
Relink requests read_products, read_content, read_themes, and write_url_redirects. Nothing on your storefront is touched during scanning — Relink talks to the Admin API only.
2. Run your first scan
Once installed, you'll land on the dashboard. Hit Scan store to start the first crawl. A typical 500-product store takes two to four minutes; large catalogs can take longer.
- Click "Scan store"Relink queues a scan job and shows a live progress bar.
- Wait for the queue to drainYou can close the tab — the scan runs on a background worker.
- Review broken linksOpen the Open broken links table to see what was found.
3. Review what it found
Every broken link gets a row in the dashboard table. Click a row to open the side drawer with the AI's suggested replacement, the source page where the link appears, and an Apply / Ignore / Change action.
4. Apply your first fix
Click any row, review the AI's suggestion in the drawer, and hit Apply fix. Relink does two things atomically:
- Patches every place the broken URL appears (product descriptions, pages, blog posts, metafields) to point at the new URL.
- Creates a native Shopify URL redirect so any external traffic — backlinks, search results, cached pages — lands on the right page.
If you change your mind, every fix has a one-click Undo on the Fix history page. Undo restores the original anchor and deletes the Shopify redirect.
What to read next
Now that you've shipped your first fix, the rest of the docs go deeper into individual features:
- Running a scan — what gets crawled, how the queue works, scan history.
- AI suggestions — how matches are picked and what the confidence score means.
- Fix modes — switch between Review and Auto-fix, or use a Global Redirect URL.
Need a hand?
Email laurencetuchin@gmail.com — average reply under one business day.