Docs Getting started
Documentation

Getting started

Install Relink from the Shopify App Store, run your first scan, and review your first AI-suggested fix in under five minutes.

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 and update your products, collections, pages, blog posts and URL redirects.

Note

Relink requests read and write access to products, content (blog posts), online store pages and online store navigation (URL redirects). Nothing on your store changes during scanning, and nothing changes until you approve a fix.

2. Run your first scan

Once installed, you’ll land on the dashboard. Click Run first scan to start. A typical 500-product store takes two to four minutes; large catalogs can take longer.

Relink · Dashboard
Scan in progress
Checking products · 324 of 506 pages checked
  1. Click "Run first scan"Relink starts the scan and shows a live progress bar.
  2. Wait for the scan to finishYou can close the tab — the scan keeps running.
  3. Review broken linksThe dashboard lists what was found.

3. Review what it found

Every broken link gets a row in the dashboard table. Click its address to open the side drawer with Relink’s suggestion, the pages where the link appears, and actions to apply, change or ignore it.

Relink · Open broken links
Open broken links
18
found by the scan
Ready to apply
14
high confidence
Needs review
3
lower confidence
No suggestion
1
pick a page yourself
/products/ceramic-mug-blue-old
Found in: products/ceramic-mug-collection
AI · 96%
/pages/winter-2023-sale
Found in: pages/about, pages/contact
Manual
/collections/discontinued-tees
Found in: blogs/news/summer-sale
Heuristic

4. Apply your first fix

Click a broken link, review the suggestion in the drawer, and click Apply to this page (or Apply to 12 pages when the link is on 12 pages). Relink does two things:

  • Changes the link on the pages you chose (product descriptions, pages, blog posts, collection descriptions) to point at the new page.
  • Creates a native Shopify URL redirect so any external traffic — backlinks, search results, cached pages — lands on the right page.
Before
/products/ceramic-mug-blue-old
404 — referenced from your collection page and one blog post.
→
After
/products/ceramic-mug-cobalt
AI picked the new SKU based on title, tags, and descriptions.
Heads up

If you change your mind, every redirect or replacement has a one-click Undo on History. Undo puts the old address back and removes the Shopify redirect. If a page was edited since, part of it may not go back. You can’t undo a removal.

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, past scans.
  • AI suggestions — how suggestions are picked and what the confidence score means.
  • Fix modes — switch between Suggest and Automatic fixes, or send every link to a fallback page.

Need a hand?

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

Install Relink