# Filtered Topic Lists

**URL:** <https://meta.discourse.org/t/filtered-topic-lists/321031>\
**Category:** Theme component\
**Created:** [August 10, 2024, 1:30pm UTC](https://meta.discourse.org/t/filtered-topic-lists/321031 "2024-08-10T13:30:28Z")\
**Posts on this page:** 1\
**Showing post:** 1

<div class="post-metadata">

**Author:** ![gormus](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/gormus/32/428592_2.png) [@gormus](https://meta.discourse.org/u/gormus)\
**Post date:** [August 10, 2024, 1:30pm UTC](https://meta.discourse.org/t/filtered-topic-lists/321031/1 "2024-08-10T13:30:28Z")

</div>

| | | |
| --- | --- | --- |
| ℹ | **Summary** | Allows creating custom topic list using filters. The lists then can be displayed in selected plugin outlet for selected pages. |
| 👓 | **Preview** | [Theme Creator](https://discourse.theme-creator.io/theme/gormus/filtered-topic-lists) |
| 🛠 | **Repository** | [https://github.com/gormus/discourse-filtered-topic-lists](https://github.com/gormus/discourse-filtered-topic-lists) |
| ❓ | **Install Guide** | [How to install a theme or theme component](https://meta.discourse.org/t/how-do-i-install-a-theme-or-theme-component/63682) |
| 📖 | **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

Allows creating custom topic lists using the topic filters. The lists then can be displayed on selected pages, in selected plugin-outlets.

You can create as many lists as you need, define their headings, how many topics should be listed, what filters should be used for the query, and above all what pages they should be displayed on, and where on those pages.

 ![Edit preset settings](https://global.discourse-cdn.com/meta/original/4X/b/2/7/b276abae375cc9d9c4a50e7011b7a5dbbeef87da.png)

Make sure to review the experimental topic list filter feature, and supported filters:

> [@Topics list filter feature](https://meta.discourse.org/t/experimental-topics-list-filter-feature/263641):
>
> We have recently introduced an innovative [/filter](https://meta.discourse.org/filter) route, enabling more sophisticated filtering of the topics list. Significantly, this marks the initial step towards a unified topic filtering language for both search and filtering. Additionally, the dedicated route for topic list filtering enhances the customizability of the sidebar, as users can now incorporate links as [custom section links](https://meta.discourse.org/t/custom-sidebar-sections-being-tested-on-meta/255303) within the sidebar. How it works The [/filter](https://meta.discourse.org/filter) has an input field which users can input a query string to …

#### Settings

- **Title** : An optional heading text; when provided it is displayed above the topic list.

- **Length** : The number of topics to display.

- **Query** : The query to filter the list

- **Plugin Outlet** : The curated topic lists can be placed in following plugin outlets/regions:

- **Show on** : The page to display the list on.

- **Selected categories** : When `show on` setting is set to `selected_categories`, the categories selected in this field are used. The topic list will be shown on these category pages only.

- **Selected tags** : When `show on` setting is set to `selected_tags`, the tags selected in this field are used. The topic list will be shown on these tag pages only.

#### Plugin Outlets

All available plugin outlets are rendered with red dashed rule around them.

 ![All available plugin outlets](https://global.discourse-cdn.com/meta/original/4X/0/d/2/0d2ce7fdb2ed69ad04c9be4e496cac689e6d97cd.jpeg)

#### Inspiration

I was inspired by the Featured Lists theme-component. But at the end, I needed a less-opinionated, and more flexible solution for my project.

Make sure to check it out:

> [@Featured Lists](https://meta.discourse.org/t/featured-lists/288916):
>
> information_sourceSummary Create and feature custom topic listshammer_and_wrenchRepository [Manuel Kostka / Discourse / Components / Featured Lists · GitLab](https://gitlab.com/manuelkostka/discourse/components/featured-lists)questionInstall Guide [How to install a theme or theme component](https://meta.discourse.org/t/how-do-i-install-a-theme-or-theme-component/63682)open_bookNew 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 The component lets you filter custom topic lists and showcase them on your forum. Default look Settings Editor Stylin…

---

_[View the full topic](https://meta.discourse.org/t/filtered-topic-lists/321031)._