How do you customize Physical mailing address present?
email-physical-address-presentfunctionalrequired1 credit per run
Strip HTML tags from body and match physical address patterns (street number + street + city/state/postal code).
When is a custom rule warranted?
Set `senderPostalAddress` when you want the strong form of the check: with your real address supplied, a footer carrying somebody else's address, or a stale address from a previous office, fails instead of passing. Set `expectedAddressCountries` when you send from or to Canada, so CASL's anchors run alongside or instead of the US ones. Extend `recipientAddressLabels` if your templates label recipient addresses in wording the defaults do not cover, or in a language other than English.
When should you stay on the Standard?
Stay with presence-only detection while your address is genuinely in flux — mid-move, mid-restructure — because a check configured to an address you are about to leave will fail correct mail. Keep the default country list if you send only to US recipients, since adding anchors for regimes you are not subject to only widens what counts as a pass. If your mail is transactional, the right answer is not a narrower configuration but leaving the check out.
What are the trade-offs?
Supplying `senderPostalAddress` is the strictest and therefore the most maintenance-sensitive setting: the moment your registered address changes, correct mail starts failing until someone updates the value, and the temptation is to clear it rather than correct it. Adding countries widens the set of formats that satisfy the check, which can let an address that is valid somewhere pass where you needed one valid locally. Extending recipient labels reduces false positives but each addition is also a phrase the check will now decline to count, so an over-broad label list can hide a genuinely missing sender address.
How is a custom rule governed?
The Standard configuration transcribes what the statute and postal standards require rather than what any organisation prefers, which is why presence-only is the default and country anchors are explicit. A Custom configuration — especially your own postal address — is legal information and should come from whoever owns the entity's registered details, not from a marketing template. Because this check's output is the kind of thing that ends up in a compliance file, record when the address value was last confirmed.
What does a configured rule look like?
A US company sets `senderPostalAddress` to its registered office address, upgrading the check from "an address is present" to "our address is present" and catching footers still showing a previous office. A sender with Canadian subscribers sets `expectedAddressCountries` to `["US", "CA"]` so CASL anchors run and Canadian-format addresses are recognised properly. An ecommerce brand whose confirmation templates print delivery details adds its own wording to `recipientAddressLabels`, so the buyer's address is never mistaken for the sender's when the footer block is missing.
How does an agent call it with your config?
{
"type": "email",
"validations": [
{ "id": "email-physical-address-present", "config": { /* your overrides */ } }
]
}What can you configure?
expectedAddressCountriesrecommendednon-empty-string-arrayStandard default: US
senderPostalAddressrequiredoptional-stringStandard default:
recipientAddressLabelsrecommendednon-empty-string-arrayStandard default: ship toshipping addressdeliver todelivery addressbill tobilling addresssold toyour address
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.