Link health and accessibility checks
Linkdeck checks your links regularly and flags readability problems as you edit. Here's what each warning means and how to fix it.
Updated
A broken link or hard-to-read text quietly costs you clicks. The Page checks panel in the editor watches for both. Open the editor (/app) and scroll below your blocks to find it.
The panel has two parts: Links, which checks that your links still work, and Accessibility, which checks that everyone can read and use your page.
Broken-link alerts
Linkdeck visits each web link on your published page about once a day to make sure it still opens. For a smart link, the main address and every rule's address are checked; if a rule's address is broken, the warning says which rule. Email (mailto:) and phone (tel:) links aren't checked, and neither are links you've hidden with the switch in your block list.
Each link ends up in one of three states:
| State | What it means |
|---|---|
| Working | The site opened normally. |
| Looks broken | The page wasn't found (404), was removed (410), the site returned a server error (500 or above), or the site couldn't be reached or timed out. |
| Couldn't check | The site refused the check, for example with a 401, 403 or 429 response. |
Couldn't check isn't the same as broken
Many sites, such as shops, social networks and booking tools, block automated visitors. When that happens, the link shows as Couldn't check, with the code the site sent back. This usually means the site blocks automated checks, not that the link is broken. Open the link yourself to be sure. If it works in your browser, there's nothing to fix.
Fix a broken link
- In Page checks, find the link marked "looks broken". The message says what went wrong and shows the address.
- Click Fix to open the link.
- Correct the URL, or replace it with the page's new address.
- Click Save.
After you change a link's address, its old result is hidden until the link is checked again. To check straight away, click Check links now.
Check links now
Click Check links now at the top of Page checks to check your links without waiting for the daily check. It checks up to 20 addresses at a time, starting with the ones that were checked longest ago, so on a page with more links you can click it again to check the rest.
Below the list, the panel shows how many of your checked links are working and when they were last checked.
Alerts
A link counts as broken for an alert only after it has failed two checks in a row, about a day apart. That way a short outage on the other site doesn't set off an alert. You're told once per break, not every day.
- Where email notifications are available, you get an email listing the broken links, with a button to open the editor.
- If you've added a webhook with the A link breaks event in Settings (
/app/settings), it's sent at the same time.
The panel itself always shows the latest result, even before an alert goes out.
Accessibility checks
The Accessibility part of Page checks looks at your page as you edit and lists anything that could make it hard to read or use, for example for people with low vision or who use a screen reader. Red items are the most important to fix. Amber items are worth a look.
When everything is fine, it says No problems found.
Text and background contrast
Linkdeck compares your text color with your background color using the standard contrast measure for the web. It aims for at least 4.5 to 1. Below 3 to 1 is marked red.
To fix it, go to Appearance (/app/appearance) and make the text darker or the background lighter, or the other way round. With a gradient background, both colors are checked and the weaker result is shown.
If your background is a photo, Linkdeck can't measure the contrast. Check that your name and bio are easy to read on a phone, or pick a darker or plainer photo.
Button text contrast
The same check runs on your button text against the button color. To fix it, change the button text color or the button color in Appearance.
Images without a description
An image block with no description gives screen reader users no idea what it shows. Click Fix, then fill in Alt text with a short description, such as "Maya holding the new autumn mug", and click Save.
Links that don't say where they go
- A link with no title is marked red, because screen readers only read out its web address. Give it a title that says where it goes.
- Vague titles such as "Click here", "Here", "Link", "More", "Read more", "Learn more", "Tap here" or "Go" are flagged, because they don't make sense on their own. Use something like "Book a lesson" or "Shop the autumn collection".
- Duplicate titles: two links with the same title that go to different places are flagged. Give each link its own title.
Embeds without a title
An embedded player, such as a YouTube video or Spotify playlist, with no title is flagged. Add a short title to the embed block so screen readers can name it.
Hidden blocks are left out of the accessibility checks, since visitors can't see them.
Related
Still stuck? Send us a message, or go back to all help topics.