# Featured Tiles

**URL:** <https://meta.discourse.org/t/featured-tiles/156677>\
**Category:** Theme component\
**Tags:** official, featured-tiles\
**Created:** [July 3, 2020, 8:47am UTC](https://meta.discourse.org/t/featured-tiles/156677 "2020-07-03T08:47:25Z")\
**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/580155_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)\
**Post date:** [July 3, 2020, 8:47am UTC](https://meta.discourse.org/t/featured-tiles/156677/1 "2020-07-03T08:47:25Z")

</div>

| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Featured Tiles** adds a row of featured tiles above topic lists. |
| 👓 | **Preview** | [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/featured-tiles) |
| 🛠 | **Repository Link** | [https://github.com/discourse/discourse-featured-tiles](https://github.com/discourse/discourse-featured-tiles) |
| 📖 | **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=featured-tiles "Ask for support on configuring and using Featured Tiles") [🐛&nbsp; **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=featured-tiles "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=featured-tiles "Discussion about the user interface of Featured Tiles, and how features are presented (including language and UI elements)") [💡&nbsp; **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=featured-tiles "Discussion about how existing Featured Tiles features can be improved or enhanced, and how proposed new features could work")

### Features

**Featured Tiles** adds a row of featured tiles above topic lists.

 ![Screenshot 2020-07-03 at 09.44.37](https://global.discourse-cdn.com/meta/original/3X/2/e/2e578ed212df3b05989cb38ffebf9ad253739b4c.png)

On hover, the topic title and author will be shown:

 ![Screenshot 2020-07-03 at 09.43.52](https://global.discourse-cdn.com/meta/original/3X/b/7/b71c5c071dccb65c9764d96ecdabd58fcc414c9a.jpeg)

There are lots of options available for selecting the topic source. Images can be fetched by tag, by category or by using a ‘top topics’ time period. Images can be scoped to the currently viewed category, or come from the entire site.

A setting is added to the user interface preferences which allows users to hide the banner on the current device.

### Settings

| Name | Descriptions |
| --- | --- |
| featured category | The category containing featured topics. Set to 0 for all categories. ‘Scope to category’ will override this setting. |
| featured tags | The tag which contains the featured topics. This must be publicly visible. |
| topic source | Which algorithm should be used to pick topics |
| top period | The time period used when “topic\_source” is set to “top” |
| randomize topics | Randomize the selection and ordering of topics |
| display when unfiltered | Display on the unfiltered latest page |
| display on categories | Display on category pages |
| display categories | Display the tiles when viewing these categories. Blank for all categories |
| maximum topic count | The maximum number of topics to display |
| scope to category | Filter topics to the current category |
| display mobile | Display on mobile devices |

| Translation | Default |
| --- | --- |
| preference\_header | Featured Topics Banner |
| preference\_description | Show featured topics banner on this device |
| | |

  

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

> Last edited by @JammyDodger 2024-06-12T16:15:01Z
> 
> > **Check document**
> >
> > Perform check on document:

---

_[View the full topic](https://meta.discourse.org/t/featured-tiles/156677)._
