Featured Lists

AI-generated summary

manuel introduces Featured Lists, a theme component that allows administrators to create, filter, and showcase custom topic lists on their forum. The component is highly customizable via CSS, supporting various design styles, and includes a settings editor for configuration. It utilizes specific CSS classes (.featured-lists__wrapper, .featured-lists__list-container, etc.) for styling.

Users raised several questions regarding functionality and customization. digitaldominica asked how to hide “About the category” topics and empty rows. manuel confirmed that empty lists are no longer rendered after an update and suggested using CSS to hide pinned topics, as there is no dedicated class for “About” topics. digitaldominica later clarified that they wanted the “Post” button to direct users to the specific category of the list rather than the admin default; manuel explained this functionality is already built-in, pre-filling the composer based on the list’s category or site settings.

Other inquiries included hiding specific lists on certain pages. hoangviet and Maria asked about hiding lists on specific categories or moving them below content. manuel and manuel advised using CSS or placing the component on different plugin outlets. manuel also noted that custom class names can be assigned to lists for targeted styling.

Regarding limitations, manuel stated that displaying categories instead of topics requires a different component, such as Featured Categories Header. dmitcha reported an issue where the display count reverted to 3; manuel clarified that the setting must be saved twice (in the editor and on the main page). Stephane_Roy reported a display bug with Topic Cards, which manuel resolved by updating the component to the new Glimmer topic list component.

Finally, manuel explained that the component uses default topic list styling and cannot be isolated from other theme changes. satonotdead asked about custom URLs, and manuel clarified that only specific routes from the dropdown are supported. After a breakage in Discourse v2026.9.0, manuel merged a PR to fix the error and moved the repository back to GitHub for better alignment with update tools.

Install this theme component

The component lets you filter custom topic lists and showcase them on your forum.

Default look

Settings Editor

Styling

For CSS styling the component structure is:

.featured-lists {
  &__wrapper { }

  &__list-container { }

  &__list-header { }

  &__list-body { }
}

For example you could style an old-school board look:

Or modern minimal panels:

If you do custom styles, please share them on this topic! :sparkles: :sparkling_heart:

30 Likes

Hi, how can i prevent the about the category topic from being displaed in the featured lists?

Also is it possible to hide a row if there is no topics within it? For example if i use a row for New topics it shows empty with the row information but no topics.

1 Like

Thanks for the feedback! I just updated the component, so it doesn’t render empty lists.

I don’t see a dedicated class for the about topics. But you could use a style declaration to hide pinned topics from the featured lists:

.featured-lists__list-body .topic-list-item.pinned {
  display: none;
}
2 Likes

Thanks for the update, it works out great. Is it possible in the future that the post button by more actually posts to the designated category for the corresponding row?

2 Likes

That should already work like this:

  • If you set a category or a tag the composer will pre-fill either or both.

  • If the list has no set category, the composer will pre-fill with the value from the site-wide setting default composer category:

How does it not work for you?

2 Likes

Nice component @manuel, I really like this, especially how easily customizable you made it so it can be adapted to other themes. Great work and thanks for sharing! :clap: :slight_smile:

2 Likes

Hi yes this works, what I was asking is if I set a category on a row that is different from the default one in admin, can a person who clicks post go to that category and not the one set in the admin settings?

I’m not sure what you’re trying to achieve.. could you explain it with an example?

1 Like

If I set show on to Everywhere
How to hide Featured Lists when opening topics of a specific category?

You could either fork the component and add your specific condition to discourse-featured-lists/javascripts/discourse/components/featured-lists-wrapper.gjs at main · nolosb/discourse-featured-lists · GitHub.

Or just use some CSS declarations to hide the component on your specific categories.

This theme-component is awesome! Apologies for necroing this topic, but I have a question about this component.

Would it be possible to display categories instead of topics?

For example, instead of this list body containing four different topics, it would contain four different categories, and clicking on one of them would direct you to that category.

1 Like

A nice plugin - thanks! In the plugin editor, I tried to increase the display count from 3 to 5. It saves, but then it reverts to 3, even though several categories have more than 3 items. Is there a way to override the max=3, or another approach to achieve this?

With the editor you have to save twice, once on the editor window:

And then again on the component’s main page:

image

Maybe that’s causing your issue? Setting any number of topics works fine for me.

2 Likes

That was exactly it; I missed that step. Thank you very much for your speedy reply and very useful plugin.

2 Likes

I am wondering… Couldn’t the About topic be unpinned and unlisted?

I guess you could. The result would be different though, the topic being generally hidden. In my experience it’s actually more common that you would want to show a selection of just the most recent topics on a featured list, but still want pinned and also About topics visible in other places.

1 Like

I would be curious with it being a special topic(ie ppl have discovered they really don’t want to be deleted). That unpinninf and unlisting in theory shouldn’t affect for example category description in is it Category Boxes?

Hey, this component works almost perfect for me, however i would like to have the option to place the lists below instead of above.

image

Is there an easy way to do this? From what i saw in the repo it looks like it is not yet intended.

@Maria you could place the component on any plugin outlet. You can use the Plugin outlet locations component to inspect available outlets.

1 Like

@manuel @Lilly about Css.
I have 2 lists from 2 categories: Yoga and Fitness.
I am setting both lists to display everywhere.
How to hide the list of “Yoga” when opening any topic (it will still show on the home page, category and other places)
The list of “Fitness” is still displayed everywhere.

Thanks to the experts of Discourse