> ## Documentation Index
> Fetch the complete documentation index at: https://documentation.outpost.pub/llms.txt
> Use this file to discover all available pages before exploring further.

# Newsletter Preview Text

> Set the preview text that inbox apps show after the subject line of a Ghost newsletter, using the post excerpt.

Inbox apps such as Gmail, Apple Mail and Outlook show a line of preview text after an email's subject line. This is sometimes called the preheader. Ghost adds preview text to every newsletter it sends, and takes it from the post's excerpt. You set the excerpt in the post editor. No custom code or changes to your email template are needed.

***

## Set the preview text

**1. Write an excerpt**

In the post editor, open the post settings panel and fill in **Excerpt**. An excerpt can be up to 300 characters.

If your site has **Show post excerpt inline** switched on under Labs in Ghost's settings, the excerpt field sits just below the post title instead, and reads **Add an excerpt** when it is empty.

**2. Send yourself a test**

While the post is a draft, click **Preview**, switch to **Email**, click **Test**, and send the test email to yourself. Check how the subject and preview text look in your own inbox, on a phone and on a computer.

**3. Publish and send**

The newsletter goes out with your excerpt as its preview text.

> [!TIP]
>
> Write an excerpt for every post you send as a newsletter. That excerpt becomes the preview text. You can change it after the newsletter goes out, for example to word it differently for your site or social shares. Emails already sent keep the original.

***

## When the excerpt is empty

If a post has no excerpt, Ghost uses the opening text of the post instead, such as the first line of your introduction or the caption of a photo at the top.

A free member's preview never shows text from a paid-only section of the post.

***

## Where else the excerpt appears

The excerpt is not only used in email. Depending on your theme, it can also appear:

* on your site, under the post title or on post cards in lists of posts;
* in link previews when someone shares the post on social media;
* in the newsletter itself, under the post title. To show it there, open your newsletter's settings in Ghost, go to the **Content** tab, and switch on **Post excerpt** in the **Title section**.

Write the excerpt so it reads well in all of these places. If you want different wording for social media, open **Meta data** in the post settings panel. The **X card** and **Facebook card** tabs each have a description field. When you fill one in, Ghost uses it instead of the excerpt.

***

## Writing good preview text

1. **Add to the subject line instead of repeating it.** The subject gets the email opened and the preview text gives a second reason. For example, the subject "The council vote is tonight" with the preview text "Here's what each option would cost you, in two minutes."
2. **Put the important words first.** Phones show less of the preview than computers do, so the opening words should make sense by themselves.
3. **Keep it to one short sentence.** Inboxes show only part of a long excerpt. Readers see the full excerpt on your site and in the other places it appears.
4. **Check it before you send.** A test email to yourself shows exactly what readers will see.

***

## Related features

> [card] [Ghost](https://documentation.outpost.pub/integrations/ghost.md)
>
> How Outpost connects to your Ghost site.

> [card] [Ghost Compatibility](https://documentation.outpost.pub/faq/ghost-compatibility.md)
>
> Questions about Ghost versions, hosting and how Ghost works with Outpost.

***

## FAQ

> [accordion] Do I need custom code to add a preheader to a Ghost newsletter?
>
> No. Ghost adds a preheader to every newsletter and takes it from the post's excerpt. Fill in **Excerpt** in the post settings panel and that becomes the preview text.

> [accordion] Why does my newsletter preview text show the opening of my post?
>
> The post has no excerpt, so Ghost used the opening text of the post instead. Write an excerpt to choose the preview text yourself. See [Set the preview text](#set-the-preview-text).

> [accordion] Can a newsletter's preview text be different from the excerpt on my site?
>
> Not at the same time: Ghost uses the excerpt for both. You can change the excerpt after the newsletter has gone out, which changes the site and later social shares without affecting emails already sent. For social media alone, use the descriptions on the **X card** and **Facebook card** tabs under **Meta data** in the post settings panel.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.