# 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:** 20
**Page:** 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:

---

<div class="post-metadata">

### Author: ![Paracelsus](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/paracelsus/32/164912_2.png) [@Paracelsus](https://meta.discourse.org/u/Paracelsus)
#### Post date: [May 14, 2020, 7:24pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/3 "2020-05-14T19:24:43Z")

</div>

Great, a blog-like topic listing (together with Topic List Thumbnails Component)! 👏

Can it be restricted by category like the other component?

---

<div class="post-metadata">

### Author: ![david](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/david/32/157490_2.png) [@david](https://meta.discourse.org/u/david)
#### Post date: [May 15, 2020, 1:01pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/4 "2020-05-15T13:01:50Z")

</div>

Sure, I just added a category setting:

[https://github.com/discourse/discourse-topic-excerpts/commit/aed85ba07007d38fe98de8889e3b155c69aeb812](https://github.com/discourse/discourse-topic-excerpts/commit/aed85ba07007d38fe98de8889e3b155c69aeb812)

---

<div class="post-metadata">

### Author: ![Paracelsus](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/paracelsus/32/164912_2.png) [@Paracelsus](https://meta.discourse.org/u/Paracelsus)
#### Post date: [May 15, 2020, 5:51pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/5 "2020-05-15T17:51:06Z")

</div>

Thanks, much appreciated.

I also take the chance to report that there is some kind of incompatibility with the Topic Thumbnails component, since the images appear twice for each topic in the topic list (topic list option on thumbnails component + topic excerpts component).

---

<div class="post-metadata">

### Author: ![david](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/david/32/157490_2.png) [@david](https://meta.discourse.org/u/david)
#### Post date: [May 18, 2020, 2:30pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/6 "2020-05-18T14:30:43Z")

</div>

> [@Paracelsus](#):
>
> some kind of incompatibility with the Topic Thumbnails component

You’re right, sorry about that. Should be fixed now

[https://github.com/discourse/discourse-topic-excerpts/commit/301f77e50c8ed231d7e4c8cb6ce69d35c7e06707](https://github.com/discourse/discourse-topic-excerpts/commit/301f77e50c8ed231d7e4c8cb6ce69d35c7e06707)

---

<div class="post-metadata">

### Author: ![downey](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/downey/32/166878_2.png) [@downey](https://meta.discourse.org/u/downey)
#### Post date: [March 3, 2021, 11:44pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/15 "2021-03-03T23:44:22Z")

</div>

Love this component; thank you! ~~Is there any way to adjust the word/character length of the excerpts displayed in topic lists?~~ (Never mind, I found the `topic excerpt maxlength` site setting, adjusted it, and rebuilt HTML for the topic posts in question.)

---

<div class="post-metadata">

### Author: ![th21](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/th21/32/211915_2.png) [@th21](https://meta.discourse.org/u/th21)
#### Post date: [April 3, 2022, 12:36am UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/26 "2022-04-03T00:36:21Z")

</div>

The category setting works but the tag setting is not working on the latest discoures.

---

<div class="post-metadata">

### Author: ![david](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/david/32/157490_2.png) [@david](https://meta.discourse.org/u/david)
#### Post date: [April 12, 2022, 11:02am UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/27 "2022-04-12T11:02:17Z")

</div>

@th21 tag handling should now be fixed - sorry for the delay!

---

<div class="post-metadata">

### Author: ![Canapin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/canapin/32/119591_2.png) [@Canapin](https://meta.discourse.org/u/Canapin)
#### Post date: [September 12, 2023, 12:50pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/29 "2023-09-12T12:50:02Z")

</div>

A post was split to a new topic: [Being able to display excerpts for some categories only on /latest](https://meta.discourse.org/t/being-able-to-display-excerpts-for-some-categories-only-on-latest/278713)

---

<div class="post-metadata">

### Author: ![Canapin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/canapin/32/119591_2.png) [@Canapin](https://meta.discourse.org/u/Canapin)
#### Post date: [September 12, 2023, 12:30pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/32 "2023-09-12T12:30:46Z")

</div>

A post was split to a new topic: [Differentiate contents from the topic list rows using different colors](https://meta.discourse.org/t/differentiate-contents-from-the-topic-list-rows-using-different-colors/278710)

---

<div class="post-metadata">

### Author: ![Ryan121](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/ryan121/32/335977_2.png) [@Ryan121](https://meta.discourse.org/u/Ryan121)
#### Post date: [November 1, 2023, 4:55pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/34 "2023-11-01T16:55:29Z")

</div>

Hi,why the read more is grey in my site but in yours is blue, how can i chane the color?

---

<div class="post-metadata">

### Author: ![Arkshine](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/arkshine/32/298682_2.png) [@Arkshine](https://meta.discourse.org/u/Arkshine)
#### Post date: [November 1, 2023, 5:08pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/35 "2023-11-01T17:08:11Z")

</div>

Hi, you can use CSS to customize.

For example, using the predefined color for links. Though, you can provide the [color](https://developer.mozilla.org/fr/docs/Web/CSS/color) you want.

```css
.topic-excerpt-more {
    color: var(--tertiary);
}

```

---

<div class="post-metadata">

### Author: ![digitaldominica](https://avatars.discourse-cdn.com/v4/letter/d/97f17d/32.png) [@digitaldominica](https://meta.discourse.org/u/digitaldominica)
#### Post date: [January 12, 2024, 8:28am UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/36 "2024-01-12T08:28:56Z")

</div>

Hi, this component gets rendered on the discourse docs plugin page and makes the excerpt clickable to the url of the discourse discussion not the doc url, is there anyway to avoid this from happening?

---

<div class="post-metadata">

### Author: ![David\_Ghost](https://avatars.discourse-cdn.com/v4/letter/d/c37758/32.png) [@David\_Ghost](https://meta.discourse.org/u/David_Ghost)
#### Post date: [February 25, 2024, 8:36pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/37 "2024-02-25T20:36:48Z")

</div>

Hi, it’s possible to show the latest post instead of the first post?

---

<div class="post-metadata">

### Author: ![dsims](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/dsims/32/485916_2.png) [@dsims](https://meta.discourse.org/u/dsims)
#### Post date: [May 17, 2024, 12:36pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/38 "2024-05-17T12:36:54Z")

</div>

I have a plugin + theme-component for this: [Topic List Latest-Post Excerpt](https://meta.discourse.org/t/topic-list-latest-post-excerpt/306749)

---

<div class="post-metadata">

### Author: ![David\_Ghost](https://avatars.discourse-cdn.com/v4/letter/d/c37758/32.png) [@David\_Ghost](https://meta.discourse.org/u/David_Ghost)
#### Post date: [May 28, 2024, 1:27pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/39 "2024-05-28T13:27:05Z")

</div>

There is a problem with the theme component in desktop?

when i have it enabled, thats shows avatars like that:

 ![L'image montre une pile de tags de discussion avec différents symboles et lettres, et un compteur indiquant le chiffre 6 sur un fond sombre. (Captioned by AI)](https://global.discourse-cdn.com/meta/original/4X/f/3/3/f333360abc4fcfd64c5f0221c4942d2a3b6985b7.png)

i have updated my discourse today

EDIT: IS there a way to limit the number of lines/characters for the excerpt?

---

<div class="post-metadata">

### Author: ![eisammy](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/eisammy/32/528804_2.png) [@eisammy](https://meta.discourse.org/u/eisammy)
#### Post date: [December 29, 2024, 5:02pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/40 "2024-12-29T17:02:11Z")

</div>

Yeah same here

Lastest it’s okay when logouted but others routes when **[discourse-right-sidebar-blocks](https://meta.discourse.org/t/right-sidebar-blocks/231067)** are enabled this happen

 ![image](https://global.discourse-cdn.com/meta/original/4X/6/4/6/646dd1d6dba1203ede4d8a8f57dac62ac3873730.png)

---

<div class="post-metadata">

### Author: ![Jagster](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/jagster/32/192154_2.png) [@Jagster](https://meta.discourse.org/u/Jagster)
#### Post date: [March 3, 2025, 11:26am UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/41 "2025-03-03T11:26:54Z")

</div>

The excerpt toggle button isn’t visible on mobiles. By desing, an accident or am I asking too early?

---

<div class="post-metadata">

### Author: ![WorldIsMine](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/worldismine/32/455660_2.png) [@WorldIsMine](https://meta.discourse.org/u/WorldIsMine)
#### Post date: [March 20, 2025, 2:29pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/42 "2025-03-20T14:29:43Z")

</div>

I love this! Is there any way to block excerpts from showing on private messages?

---

<div class="post-metadata">

### Author: ![Canapin](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/canapin/32/119591_2.png) [@Canapin](https://meta.discourse.org/u/Canapin)
#### Post date: [March 20, 2025, 3:45pm UTC](https://meta.discourse.org/t/topic-list-excerpts/151520/43 "2025-03-20T15:45:55Z")

</div>

I’ve tried this component, and it doesn’t show excerpts on personal messages. 🤔

[Next page](https://meta.discourse.org/t/topic-list-excerpts/151520.md?page=2)
