Set custom preheader/preview text

An email's preheader text (more accurately referred to as "preview text") is the small block of text shown in an end-user's email inbox, next to or underneath the subject line. It's often used as a summary or an incentive to open and read the rest of the email.

Gmail Preview Text example

Normally, this preview is pulled from the first text in your email. This is OK if your content starts right away, and is short enough for a summary. However, if that isn’t the case, you might have text like ‘Is this email not displaying correctly?’ taking up valuable inbox real estate that could be used to incentivise opens instead!

In Customer.io, you can control exactly what text will appear in this preview for an email— to avoid situations like the one mentioned above.

How to specify your preview text

Simple! In the composer, click on ‘Add preheader text’ next to the subject:

preheader.gif

Save, and you’re good to go! You can also use Liquid here— customer attributes, event data (for event triggered automations), and so on.

Preview text length

We estimate that most email clients (iOS, GMail, etc.) automatically show up to 140 characters of preheader text but that number could be much lower and is, unfortunately, not within your (or our) control.

Let your preheader show your email’s opening text

Inboxes fill the rest of the preview with the first text in your email, so a short preheader is usually followed by your opening lines. To keep the preview to your preheader, Customer.io automatically adds hidden spacing characters after your preheader text when sending the email.

To manage this spacing for emails made in the classic editors, you have to add your email’s opening text to the preheader itself. There’s no way to disable the preheader spacing.

To manage this spacing for emails made in Design Studio, you can turn the spacing off for an email so your preheader text leads into the email’s content in the preview. The inbox preview then shows your preheader followed by the start of your email if there’s room, which you might want when your opening lines work as part of the preview.

Client support

Most email clients will display some kind of preview text. There’s variation in placement and length, but for most modern clients, you’re good to go. The below services do not support preview text:

DesktopMobileWebmail
Lotus Notes 8.5BlackberryGMX
Outlook 2003Web.de
Outlook 2007Freenet.de
Outlook 2010

If you want a more comprehensive guide to preview text support, check out this additional article from Litmus.

Gmail support

When searching in Gmail, the results may pull from the email’s plain text version instead of your custom preview text. This can lead to results that include lines of asterisks, and it might look like your preview text is broken or redacted. This is an issue with Gmail currently, not preheader text in Customer.io.

Updated November 10, 2026