# Topic List Excerpts

**URL:** https://meta.discourse.org/t/topic-list-excerpts/151520
**Category:** Theme component
**Tags:** official, topic-list-excerpts
**Created:** [May 14, 2020, 5:53pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520 "2020-05-14T17:53:09Z")
**Posts on this page:** 1
**Showing post:** 1

<div class="post-metadata">

### Author: ![Discourse](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/discourse/32/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [May 14, 2020, 5:53pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/1 "2020-05-14T17:53:09Z")

</div>

| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Topic List Excerpts** allows you to enable excerpts for unpinned topics (by default, Discourse only displays topic excerpts for pinned topics). |
| 👓 | **Preview** | [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/topic-list-excerpts) |
| 🛠 | **Repository Link** | [https://github.com/discourse/discourse-topic-excerpts](https://github.com/discourse/discourse-topic-excerpts) |
| 📖 | **New to Discourse Themes?** | [Beginner’s guide to using Discourse Themes](https://meta.discourse.org/t/beginners-guide-to-using-discourse-themes/91966) |

Install this theme component

> [@](#):
>
> :discourse2: As this is an #official theme component maintained by the Discourse team, #Support, #Contribute > Bug, #Contribute > UX, and #Contribute > Feature requests can be made in the respective categories here on Meta, and tagged with the appropriate theme component tag. Click on a link below to get one started. 👍
> 
> [❓&nbsp; **Support**](https://meta.discourse.org/new-topic?category_id=6&tags=topic-list-excerpts "Ask for support on configuring and using Topic List Excerpts") [🐛&nbsp; **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=topic-list-excerpts "A bug report means something is broken, preventing normal/typical use of the theme component") [👀&nbsp; **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=topic-list-excerpts "Discussion about the user interface of Topic List Excerpts, and how features are presented (including language and UI elements)") [💡&nbsp; **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=topic-list-excerpts "Discussion about how existing Topic List Excerpts features can be improved or enhanced, and how proposed new features could work")

### Features

 ![topic list excerpts example](https://global.discourse-cdn.com/meta/original/3X/7/5/753cf0a154bb8bbedbd97dad29907e915a0a1d1a.png)

Works great alongside [Topic List Thumbnails](https://meta.discourse.org/t/topic-list-thumbnails-theme-component/150602) in “list” mode!

> ℹ The excerpts themselves are generated by Discourse Core, using the same logic as the excerpts of ‘pinned’ topics. If you have a query / suggestion about how the excerpts are built, please make a new #Support topic.

* * *

💡 Tip: you can keep line breaks in excerpts by adding this CSS to your theme:

```scss
.topic-list .topic-excerpt {
    white-space: pre-line;
}

```

Be aware that results may look off depending on the posts’ contents.

### Settings

| Name | Description |
| --- | --- |
| show excerpts mobile | |
| show excerpts desktop | |
| enabled categories | Enable excerpts in specific categories. Leave both categories and tags blank to show excerpts on all routes |
| enabled tags | Enable excerpts in specific tags. Leave both categories and tags blank to show excerpts on all routes. |

  

> :discourse2: **Hosted by us?** Theme components are available to use on our Standard, Business, and Enterprise plans.

> Last edited by @JammyDodger 2024-06-15T19:28:50Z
> 
> > **Check document**
> >
> > Perform check on document:

---

_[View the full topic](https://meta.discourse.org/t/topic-list-excerpts/151520)._