How to find and fix broken links on your site
TeleportHQ checks every link on your site for you. When a button, a menu link or a link in a text leads to an address your site doesn't have, a yellow button such as 1 issue appears at the top left of the editor. Click it to open the Issues window: Broken links on pages lists each broken link with a Show button that takes you to it, and your Blog posts and Help Center articles get a list of their own. The check reads your project, so it works before you publish.
Before you start
- The TeleportHQ link check runs by itself a few seconds after the editor opens, and again after every change. There's nothing to turn on.
- No yellow issues button at the top left means your project has nothing to fix.
Open the list of broken links
- Open your project in the TeleportHQ editor.
At the top left of the editor, next to the TeleportHQ logo, find the yellow button with a warning sign, for example 1 issue.
- Click it. The Issues window opens, with a line such as "1 thing to fix for your project to work correctly".
Find the Broken links on pages section. It has one card per page or component, for example Homepage with "1 broken link". A component's card reads, for example, "Component · 1 broken link".
Click the card. It opens and shows, for each broken link:
- What the element says, for example "Browse full weekly schedule".
- Where the link points, for example
/schedule. - Why it leads nowhere, for example "No page has this address".
- Show.
- Click Show. The Issues window closes, and TeleportHQ opens the page with that element selected, ready to fix.
The same Issues window also lists settings your project still needs, such as missing credentials for a workflow, and workflow steps that still hold a value the AI left for you to replace, such as an API key or an address (Placeholder Values). The issues button counts all of them.
What each reason means, and how to fix it
The TeleportHQ link check reads every button, navigation link and text link on every page, and on every component placed on a page. It says why each link leads nowhere:
| The Issues window says | What happened | How to fix it |
|---|---|---|
| "No page has this address" | The link points to a typed address, for example /schedule, that no page and no redirect of your site uses. | Point the link at a page, or add a redirect from that address. |
| "The page it linked to was deleted" | The link pointed to a page that no longer exists. | Point the link at another page, or remove the link. |
| "The page it links to isn't published: its AI generation failed" | The page exists, but AI couldn't finish it, so publishing leaves it out. | In the Pages list, that page shows Generation failed: click Try again. Or point the link at another page. |
| "No section of this page has this anchor" | A Scroll To link names a section that's no longer on the page. | Choose another section, or give the section its ID back. See How to link to a section of the same page with smooth scrolling. |
| "Your project has no page that shows these" | The link opens one product, article or item, but your project has no page that shows such items. | Add the page that shows them (for example, turn on the store or the blog), or change the link. |
| "No Blog post has this address" (in an article's own list: "No post has this address") | The link names an article that doesn't exist. The Help Center says "article". | Change the link, or publish an article with that address. |
| "The Blog post it points to isn't published" (or "The post it points to isn't published") | The article exists but is a draft or scheduled for later. | Publish the article, or change the link. |
| "No category has this address" | The link names a Blog or Help Center category that doesn't exist. | Change the link, or create the category. |
Fix a broken link on a page
After you click Show, the element is selected on the TeleportHQ canvas. Then:
- Point the link at an existing page. In the small bar above the selected element, click the link icon. Click Page, then click the page, for example Classes. See How to add links and buttons.
- Keep an old address working with a redirect. If people may still use the address, for example from a printed flyer, send it to a page instead. Click the Project settings cog at the bottom of the left sidebar, then SEO & social → Search engines. Under Custom Redirects, click Add Redirect, set From to URL and type the address, for example
/schedule, then choose the page under To. TeleportHQ counts an address with a redirect as working. See How to hide a page from Google, set a canonical URL or redirect a page. - Remove the link. Click the × next to the link icon. The element stays, without a link.
Fix a broken link in a Blog post or Help Center article
TeleportHQ checks the text of every published and scheduled Blog post and Help Center article, in every language of your site.
- In the Issues window, find Broken links in Blog posts or Broken links in Help Center articles.
- Click the article's card. It lists each link's words, its address and why it leads nowhere.
- Click Open the post (or Open the article). The Blog or Help Center panel opens at the article's content.
- Change or remove the link in the text. If the link names a draft, publish that draft instead. See How to write and publish a blog post.
Check that it worked
As soon as you fix a link, its card leaves the Issues window and the number on the issues button goes down. When nothing is left, the button disappears. Publish your site so visitors get the fixed links. See How to publish your site.
Troubleshooting
I don't see an issues button Your project has nothing to fix. The first check runs a few seconds after the editor opens, so wait a moment after opening a project.
The Issues window says "Checking the links on your site…" TeleportHQ is still reading your Blog posts and Help Center articles. The list fills in by itself.
A link to another website is broken, but it isn't listed The TeleportHQ link check doesn't open other websites. It checks only addresses on your own site. Click such links in a preview of your site to test them. See What should I check after publishing my site?.
Good to know
- What isn't checked: links to other websites, email and phone links, links whose address comes from your data (for example, a field of a list item), and components that aren't placed on any page. On pages, a full address to your own site, such as
https://yourbakery.com/menu, is checked like/menu. - Links in drafts are checked once the article is published or scheduled.
- Links made with Page follow the page. If you change a page's address, links that point to the page keep working. Addresses typed on the URL tab don't change, so they show up here. See How to change a page's URL and create nested URLs.
- Deleting a page that other pages link to asks what happens to those links: Point them to another page, Keep them without the link or Remove them. See How to rename, duplicate or delete a page.
- Making another page the home page keeps the page's old address working with a redirect, so links to it don't break.
- After you publish, the Publish window also lists what visitors of your live site would run into, including broken links. See What should I check after publishing my site?.