WordPress glossaryAn excerpt is a short summary of a WordPress post, shown on archive pages, in search results, and in feeds instead of the full text.
An excerpt is the short teaser that stands in for a post wherever the full text would be too much: on the blog page, in category and tag archives, in search results, in RSS feeds, and in "related posts" lists. It gives readers enough to decide whether to click, and it keeps listing pages compact and quick to scan.
In WordPress, every post has an excerpt field. Fill it in and WordPress uses your text; leave it empty and WordPress writes one for you from the start of the post.
How it works
Automatic excerpts. When the field is empty, WordPress takes the first 55 words of the post content, strips out HTML tags and shortcodes, and adds "[…]" if it had to cut the text. The result is often clumsy: it can cut off mid-sentence or start with an image caption or a disclaimer.
Manual excerpts. In the block editor, open the post settings sidebar and find the Excerpt panel (in the classic editor, turn it on under Screen Options). Whatever you write there is used as is. It is not trimmed to 55 words, and no "[…]" is added. In a block theme, though, the Post Excerpt block trims every excerpt, hand-written or automatic, to the word limit set in the block's settings.
Whether a theme shows the excerpt at all is up to the theme. Classic themes call the_excerpt() in their archive templates; block themes use the Post Excerpt block inside a Query Loop. A theme that calls the_content() on archives shows full posts instead, unless the post contains a More block, which cuts it at that point.
Where excerpts appear
- Blog, category, tag, author, and date archives, if the theme uses them.
- The site's own search results page.
- RSS feeds, when Settings, then Reading, is set to include an excerpt rather than the full text.
- Widgets, related-post lists, and some social or email integrations.
- Meta descriptions: some SEO plugins can fall back to the excerpt when a post has no description of its own.
Pages do not support excerpts by default, and custom post types only do if they register support for them. A developer can add it with add_post_type_support( 'page', 'excerpt' ). WooCommerce uses the same field as the product short description shown next to the price.
Customizing excerpts in code
Two filters control automatic excerpts. Neither affects excerpts written by hand. They apply to classic themes; in a block theme, set the length in the Post Excerpt block instead.
// Use 30 words instead of 55.
add_filter( 'excerpt_length', function () {
return 30;
} );
// Replace "[…]" with a link to the post.
add_filter( 'excerpt_more', function () {
return '… <a href="' . esc_url( get_permalink() ) . '">Continue reading</a>';
} );
Put code like this in a child theme's functions.php or a small site-specific plugin, not in the parent theme, where an update would erase it.
Writing a good excerpt
- Say what the post delivers. One or two sentences on the problem it solves or the question it answers.
- Do not just repeat the opening line. The automatic excerpt already does that.
- Keep it short. Many layouts look best with 20 to 40 words; check how yours displays them.
- Match the post. A teaser that oversells leads to quick exits.
- Use the topic's natural words, because readers scan for them, but do not stuff keywords.
Excerpt or meta description?
They overlap but are not the same thing. The excerpt is visible on your own site. The meta description is a tag in the page's head that search engines may show under the title in results, and Google often rewrites it anyway. Many sites write one summary and use it for both, which works fine as long as it reads well in each place. Both are a kind of metadata about the post, and both are output by template tags or blocks in the theme.