Show a Block to Only Some Readers

A block’s condition decides who sees it — everyone, only readers on a certain kind of device, or only readers who belong to chosen audience segments. Everyone else simply doesn’t see that block; the rest of the newsletter reads normally around it.

That means you can run a wide banner for desktop readers and a compact version for phones using two blocks in the same send, or slip a members-only note, a local notice, or a tailored call to action into an edition without building and scheduling a second one — each reader sees only what’s meant for them.

Early access

Audience-based conditions (based on segments) are rolling out gradually and may not be available on your account yet. Device-based conditions (desktop/mobile) are available to everyone.

Set a condition

This works on a standalone Image or Promotion block — one that isn’t nested inside a multi-column layout. Other block types, and any block nested in a layout, don’t have a CONDITIONS section at all (see Which blocks offer it below).

1. Open your newsletter and click the block you want to set a condition on.
2. In the settings panel, scroll to the CONDITIONS section.
3. If the block offers both kinds, choose Based on devices or Based on audiences from the Display based on dropdown. If it only offers one kind, that one appears directly with no dropdown to choose from.

Based on devices

Under Display conditions, choose one:

• Display all the time — everyone sees the block. This is the default.
• Display on desktop only — the block appears for readers on a computer and is hidden on phones.
• Display on mobile only — the block appears for readers on a phone and is hidden on computers.

Based on audiences

1. Under Match audience, choose All or Any — whether a reader must match every segment you pick, or just one of them.
2. Under Segments, select one or more segments from the Custom group (segments you’ve built yourself — see User Tags and Segments) or the System group (Letterhead’s built-in engagement segments, like Loyalists or Ghosts).
3. Only readers matching your chosen segments (and match rule) see the block; everyone else gets the edition without it.

This mode works only when your newsletter sends through Letterhead’s own delivery — not a connected ESP like Iterable or Mailchimp — since resolving a condition per recipient requires Letterhead’s own send pipeline.

The choice saves with your newsletter like any other block setting, and you can change it any time before you send.

Which blocks offer it

Device conditions are available only on a standalone Image or Promotion block — one that isn’t nested inside a multi-column layout.

Audience conditions are available on most block types, including HTML blocks (which can’t offer a device condition) — everything except the Footer and the View in browser block, which always render for everyone since they carry no reader-specific content to gate. Like device conditions, a block nested inside a multi-column layout doesn’t offer an audience condition either.

Neither kind is offered on a Google Docs, Markdown, or Iterable snippet block.

Why an Iterable snippet block doesn’t offer one

If you send through Iterable, you’ll notice the snippet block has no CONDITIONS section — and it isn’t coming. It’s worth knowing why, because the reason is the same thing that makes snippets useful.

Your snippet’s HTML never passes through Letterhead. We send Iterable a placeholder in its place, and Iterable drops your stored HTML in at send time, after everything we build has already been finished and handed over. Every other block sits inside the responsive layout we wrap around it, and that layout is exactly what decides how a block behaves between a desktop screen and a phone.

So putting a device condition on a snippet would mean nesting your HTML inside ours at a stage neither of us can see, preview, or test. We can’t check the result against your templates, and we can’t predict how your styling and ours will get along once they’re combined in a real inbox. The likely outcomes are a layout that shifts between desktop and mobile, styling that fights itself, and a heavier email — and the first anyone would find out is after a live send to your audience, which is the worst possible place to learn it.

The dependable place to handle a per-device difference in a snippet is inside the snippet itself, where your own HTML is in charge and nothing of ours is wrapped around it.

Check it before you send

Switch between the desktop and mobile views in the editor’s preview. A block set to mobile only disappears from the desktop view and comes back in the mobile view, and a desktop-only block does the opposite — so you can confirm each reader gets what you intended without sending yourself a test.

The switch between the two happens at your newsletter’s mobile width, the same setting that governs the rest of your mobile layout. See How do I use the new design settings? to check or change it.

Good to know

• A few email apps always show the desktop version. Some older desktop email programs — Outlook on Windows is the common one — can’t tell how wide the screen is, so they show what a desktop reader would see. A desktop-only block appears there, and a mobile-only block stays hidden. Keep anything essential in a block that displays all the time.
• Hiding a block doesn’t make your email smaller. A hidden block is still delivered, it’s just not shown, so it still counts toward your email’s weight. Use display conditions to tailor what a reader sees, not to trim a newsletter that’s getting heavy.
• Don’t hide something a reader needs. If a link, an offer, or a piece of housekeeping matters to everyone, leave it on Display all the time rather than trusting every email app to get the switch right.

Next steps

• Adjust mobile font size and padding to tune how a block reads on phones without hiding it.
• Set up promotions to create the ad placements you can then tailor per device.