How do you customize Preheader / inbox preview text intentional?

email-preheaderfunctionalrecommended1 credit per run

The inbox preview snippet must be intentional: no boilerplate ("view in browser", unsubscribe) or leaked merge tokens next to the subject line, required preheader content present within the visible window, and no preview-garbling defects in the source.

When is a custom rule warranted?

Set `requiredPreheaderContent` when a campaign family must always carry a specific phrase in the preview — a legally required qualifier, a programme name, an offer identifier. Extend `prohibitedPreviewPatterns` when your templates have their own boilerplate first line that the defaults do not know, such as a mandatory disclaimer or a mirror-page label. Adjust `previewWindowChars` when you know your audience's dominant client and want the front-loading window to match what it really shows.

When should you stay on the Standard?

Keep the defaults when your concern is simply that preview text exists and is not boilerplate, which is what most senders need. Leave `requiredPreheaderContent` empty unless a phrase is genuinely mandatory, because demanding fixed wording in the most valuable line in the inbox is a heavy constraint on copy. Keep both numbers if you have a mixed audience, since 130 and 90 are chosen to be reasonable across clients rather than tuned to one.

What are the trade-offs?

Requiring fixed content trades open-rate flexibility for consistency, and every required phrase consumes part of a window that is already short. Extending the prohibited list risks failing legitimate copy — a campaign that genuinely offers an online version early in the body will trip a pattern written to catch boilerplate. Tightening `previewWindowChars` produces more failures on perfectly deliverable preheaders, which is useful only if your team accepts front-loading as a rule rather than a suggestion.

How is a custom rule governed?

The Standard configuration is written from observed client behaviour and from the boilerplate that real templates actually leak, which is why the required-content field is empty and the prohibited list is not. Custom values are campaign or brand policy and belong with whoever owns campaign standards; a required phrase in particular should be traceable to the obligation or programme that demands it. Review the numbers when your audience's client mix shifts, since both are claims about where a reader stops reading.

What does a configured rule look like?

A financial services sender sets `requiredPreheaderContent` to the qualifier its compliance team requires in the preview line, so a campaign that omits it fails before sending. A team whose templates open with a mandatory legal disclaimer adds that phrasing to `prohibitedPreviewPatterns`, catching sends where the disclaimer became the preview text. A mobile-dominant consumer brand lowers `previewWindowChars` to `60` to force sharper front-loading, accepting more findings in exchange for preview lines that are read in full on a phone.

How does an agent call it with your config?

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

What can you configure?

requiredPreheaderContentrequiredoptional-string

Standard default:

prohibitedPreviewPatternsrequiredregex-pattern-list

Standard default: view (this |the )?(e-?mail|message|it)? ?(in|on) ?(your )?(web ?)?browsertrouble (viewing|displaying)sent in html onlyonline versionunsubscribelorem ipsum

maxPreheaderCharsrequiredpositive-integer

Standard default: 130

previewWindowCharsrequiredpositive-integer

Standard default: 90

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.