How do you customize Links valid, reachable, and correctly redirected?

email-link-integrityfunctionalrecommended

A dead link in a sent email cannot be recalled — the traffic you paid for lands on an error page; every link must be a well-formed URL that resolves, follows a sane redirect chain and lands on a destination you approve (bot-walled links are reported as unverifiable, never failed).

When is a custom rule warranted?

Set `fetchAccountActionLinks` to `true` for transactional and operational mail where the action link *is* the message — a password reset whose link is broken is a complete failure, and skipping it to be safe means never testing the only thing that matters. Use `approvedLinkDomains` when you want destinations restricted to your own properties and approved partners, which catches agency and affiliate links nobody sanctioned. Tighten `allowedSchemes` to `https` alone when your policy forbids insecure links.

When should you stay on the Standard?

Leave `fetchAccountActionLinks` off for marketing mail — the risk of triggering a real opt-out or account action for a real subscriber outweighs the coverage you would gain. Keep `approvedLinkDomains` empty when auditing sends you did not build, since someone else's legitimate destinations are not yours to fail. Keep `maxRedirectHops` at the specification cap unless you have a documented reason, because a lower value fails links that browsers follow perfectly well.

What are the trade-offs?

Enabling action-link fetching is the consequential override: on a real recipient's message it can perform the action the link exists to perform, which is why it is framed as your assertion that no real person's account sits behind those links. A configured domain list means every new legitimate destination fails until the list is updated, and lists maintained under deadline pressure tend to be widened rather than corrected. Lowering the redirect cap catches sloppy chains but will also fail long-established shortener stacks that work.

How is a custom rule governed?

The Standard configuration transcribes outside authority where it exists — the Fetch specification's redirect cap, the safe-method discipline that governs machine fetching — and defaults to caution where it does not. The action-link flag is best treated as a per-send assertion made by someone who knows what is behind those links, not a global setting quietly switched on once. An approved-domain list is your own policy and belongs with whoever owns campaign destinations and tracking infrastructure.

What does a configured rule look like?

A team auditing password-reset mail in a test environment sets `fetchAccountActionLinks` to `true`, since every link in the message is an account action and skipping them would test nothing. A brand consolidating tracking sets `approvedLinkDomains` to its own domains plus its single approved click-tracking domain, so an agency's own shortener fails until it is either sanctioned or removed. A security-conscious sender sets `allowedSchemes` to `["https"]`, turning any surviving plain-http link into a failure rather than a footnote.

How does an agent call it with your config?

{
  "type": "email",
  "validations": [
    { "id": "email-link-integrity", "config": { /* your overrides */ } }
  ]
}

What can you configure?

approvedLinkDomainsrecommendeddomain-list

Standard default:

allowedSchemesrecommendednon-empty-string-array

Standard default: httpshttpmailtotel

maxRedirectHopsrequiredpositive-integer

Standard default: 20

fetchAccountActionLinksrecommendedboolean-flag

Standard default:

Author ArbiterQA · Reviewed by ArbiterQA · 2026-08-14

Appears in

Related

Run this check on your own assets

1,000 credits a month on the free plan. No card.