# 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:** 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: [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:

---

<div class="post-metadata">

### Author: ![Merlls\_Rizzini](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/merlls_rizzini/32/125604_2.png) [@Merlls\_Rizzini](https://meta.discourse.org/u/Merlls_Rizzini)
#### Post date: [July 12, 2020, 8:09pm UTC](https://meta.discourse.org/t/featured-tiles/156677/2 "2020-07-12T20:09:06Z")

</div>

Wow.

This is amazing! It will attract even more clicks on my forum.

@david although not selected, its showing up on categories page. Also, if a topic has no images, can we set up a default image?

![Captura de Tela 2020-07-12 às 17.07.12](https://global.discourse-cdn.com/meta/optimized/3X/0/d/0dada47e271303732c4d0e364f95111884d9bc41_2_690x55.png)

Edit: a member told me its only works on MacOS, cause he can’t see anything.

 ![unknown](https://global.discourse-cdn.com/meta/original/3X/6/f/6f344c27222e795fc8d9767fe4fc6816ac4e73c7.png)

---

<div class="post-metadata">

### Author: ![Pad\_Pors](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pad_pors/32/52016_2.png) [@Pad\_Pors](https://meta.discourse.org/u/Pad_Pors)
#### Post date: [July 13, 2020, 5:48am UTC](https://meta.discourse.org/t/featured-tiles/156677/3 "2020-07-13T05:48:08Z")

</div>

nice and functional theme ✌.

how is it different from [Homepage Feature Component](https://meta.discourse.org/t/homepage-feature-component/144264)? is it just about the style or there are some more in-depth differences?

---

<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: [July 13, 2020, 8:11am UTC](https://meta.discourse.org/t/featured-tiles/156677/4 "2020-07-13T08:11:00Z")

</div>

It is mostly the style. Plus the Homepage Feature Component is only designed to use on the homepage. This one works in a few more places.

---

<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: [July 13, 2020, 8:11am UTC](https://meta.discourse.org/t/featured-tiles/156677/5 "2020-07-13T08:11:52Z")

</div>

> [@Merlls\_Rizzini](#):
>
> Edit: a member told me its only works on MacOS, cause he can’t see anything.

Can you ask the member to check their browser error console? And also let us know which browser they are using?

---

<div class="post-metadata">

### Author: ![Merlls\_Rizzini](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/merlls_rizzini/32/125604_2.png) [@Merlls\_Rizzini](https://meta.discourse.org/u/Merlls_Rizzini)
#### Post date: [July 14, 2020, 10:53pm UTC](https://meta.discourse.org/t/featured-tiles/156677/6 "2020-07-14T22:53:12Z")

</div>

![unknown](https://global.discourse-cdn.com/meta/original/3X/a/c/ac4946a12320884fc94bf3947017c58e4b6676f5.png)

Firefox

 ![unknown (1)](https://global.discourse-cdn.com/meta/original/3X/8/2/825cdbb7cc123b011a722860c9156c48dfb071b4.png)

Chrome

---

<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: [July 15, 2020, 3:02pm UTC](https://meta.discourse.org/t/featured-tiles/156677/7 "2020-07-15T15:02:40Z")

</div>

That error looks like it’s coming from another theme component. Can you try disabling them one-by-one?

---

<div class="post-metadata">

### Author: ![ElForoViajero](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/elforoviajero/32/187116_2.png) [@ElForoViajero](https://meta.discourse.org/u/ElForoViajero)
#### Post date: [August 4, 2020, 6:13pm UTC](https://meta.discourse.org/t/featured-tiles/156677/8 "2020-08-04T18:13:13Z")

</div>

Hi,

With this configuration, the tiles should appear in all category pages right? My featured tag is “destacado”, however tiles do not show in the category page.

 ![Captura de pantalla 2020-08-04 a les 20.11.36](https://global.discourse-cdn.com/meta/original/3X/9/d/9d355885be8fc096a069cf171085bd2ff8d5825d.png)

---

<div class="post-metadata">

### Author: ![olex1216](https://avatars.discourse-cdn.com/v4/letter/o/bbe5ce/32.png) [@olex1216](https://meta.discourse.org/u/olex1216)
#### Post date: [August 6, 2020, 4:29am UTC](https://meta.discourse.org/t/featured-tiles/156677/9 "2020-08-06T04:29:59Z")

</div>

is it the same as the theme [Topic List Previews](https://meta.discourse.org/t/topic-list-previews/101646) ？

---

<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: [August 6, 2020, 8:41am UTC](https://meta.discourse.org/t/featured-tiles/156677/10 "2020-08-06T08:41:04Z")

</div>

No it’s not the same. The “Featured Tiles Theme Component” in this topic is officially maintained by the Discourse team, and it only provides what you see in the screenshot. “Topic List Previews” is a third-party plugin and/or theme with a different design and featureset.

---

<div class="post-metadata">

### Author: ![Solari](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/solari/32/186728_2.png) [@Solari](https://meta.discourse.org/u/Solari)
#### Post date: [August 8, 2020, 4:07am UTC](https://meta.discourse.org/t/featured-tiles/156677/11 "2020-08-08T04:07:27Z")

</div>

I love this.

Is there a way to have it only pull from topics with photos/images? Otherwise it seems pretty discordant when there is a row of empty grey boxes and an occasional photo.

Thanks,  
Ray

---

<div class="post-metadata">

### Author: ![coke](https://avatars.discourse-cdn.com/v4/letter/c/e47774/32.png) [@coke](https://meta.discourse.org/u/coke)
#### Post date: [August 24, 2020, 1:13pm UTC](https://meta.discourse.org/t/featured-tiles/156677/12 "2020-08-24T13:13:19Z")

</div>

@david how i can increase the quality of the pictures, and probably the size to 180x80, thanks

---

<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: [August 24, 2020, 1:24pm UTC](https://meta.discourse.org/t/featured-tiles/156677/13 "2020-08-24T13:24:24Z")

</div>

It should be using 200x200 images on regular screens, automatically scaling up to 400x400 on hidpi screens.

> <https://github.com/discourse/discourse-featured-tiles/blob/main/about.json#L8-L12>

Are you seeing something different?

---

<div class="post-metadata">

### Author: ![coke](https://avatars.discourse-cdn.com/v4/letter/c/e47774/32.png) [@coke](https://meta.discourse.org/u/coke)
#### Post date: [August 24, 2020, 1:50pm UTC](https://meta.discourse.org/t/featured-tiles/156677/14 "2020-08-24T13:50:52Z")

</div>

Can i send you PM, because my forum is age restricted.

---

<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: [August 24, 2020, 2:04pm UTC](https://meta.discourse.org/t/featured-tiles/156677/15 "2020-08-24T14:04:09Z")

</div>

Thanks for the link. Looking at the site, the problem is that the images are portrait. So we are constraining a 3072x4608 image into a 200x200 square, which makes it 133x200. Then we’re ‘filling’ a 222x150 box with it. So we’re displaying an image 133 pixels wide into something 222 pixels wide.

One solution here is to stop ‘filling’ the banner with the image, and ‘fit’ it instead. That’s the approach we take in the topic list thumbnails:

 ![Screenshot 2020-08-24 at 15.02.58](https://global.discourse-cdn.com/meta/original/3X/c/a/ca65aa5fcf2b44cbc775886f7f7467b95fe6e86d.png)

Adding a new setting to the theme component for this would be #pr-welcome if someone would like to work on it.

---

<div class="post-metadata">

### Author: ![hollyw](https://avatars.discourse-cdn.com/v4/letter/h/4da419/32.png) [@hollyw](https://meta.discourse.org/u/hollyw)
#### Post date: [September 9, 2020, 9:07pm UTC](https://meta.discourse.org/t/featured-tiles/156677/16 "2020-09-09T21:07:06Z")

</div>

This looks great, I like that the tiles don’t overwhelm the UI. I had a couple questions about configuring it.

I haven’t been able to get the featured tiles to appear on my category pages - only the homepage. My configuration is below (with my category names blacked out since we don’t want to share those right now). Anything I’m missing here?

> **Current config**
>
> ![settings](https://global.discourse-cdn.com/meta/original/3X/9/d/9d5466cc96d7704a3d191660a2ccac14f15caed5.png)

My second question - is there a way to set default images to use for the tiles, as opposed to ones pulled from the topics? We’re often going to have topics to feature that don’t have images, but still want it to look nice. If there’s not a built-in way currently, would that mean modifying the CSS or JS?

---

<div class="post-metadata">

### Author: ![Heliosurge](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/heliosurge/32/571810_2.png) [@Heliosurge](https://meta.discourse.org/u/Heliosurge)
#### Post date: [September 24, 2020, 12:47am UTC](https://meta.discourse.org/t/featured-tiles/156677/17 "2020-09-24T00:47:29Z")

</div>

Hi David!

Amazing theme component. Like others have asked. Is there a way to add default images for topics without pics?

Ie Featured1.img Featured2.img if no image is detected?

Also have an issue with Component recognizing a tag that is visible to all but says cannot find tag when I try add it.

---

<div class="post-metadata">

### Author: ![Fraudoctor](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/fraudoctor/32/196687_2.png) [@Fraudoctor](https://meta.discourse.org/u/Fraudoctor)
#### Post date: [October 10, 2020, 12:52am UTC](https://meta.discourse.org/t/featured-tiles/156677/18 "2020-10-10T00:52:27Z")

</div>

Is there a specific image type (.jpg, .png, .tiff) that this works with? Images not showing up from 2 of 3 topics which I tagged, though the topic itself shows up.

 ![image](https://global.discourse-cdn.com/meta/original/3X/c/a/ca5e2011747367c39d5a7f001872d7b35613096a.jpeg)  
OS - Mac 10.15.7 (Both Chrome, Safari and iOS version appear the same)

---

<div class="post-metadata">

### Author: ![Pad\_Pors](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/pad_pors/32/52016_2.png) [@Pad\_Pors](https://meta.discourse.org/u/Pad_Pors)
#### Post date: [January 4, 2021, 5:13pm UTC](https://meta.discourse.org/t/featured-tiles/156677/20 "2021-01-04T17:13:51Z")

</div>

the theme shows blank gray banner when activated on the site:

 ![Screenshot_2021-01-04_20-42-14](https://global.discourse-cdn.com/meta/original/3X/0/0/00d8aaac1b087473ae06c812ab8c4d54dbf32770.png)

though the tag option is clicked and there are some topics on the feature-tag.

---

<div class="post-metadata">

### Author: ![Fraudoctor](https://sea3.discourse-cdn.com/meta/user_avatar/meta.discourse.org/fraudoctor/32/196687_2.png) [@Fraudoctor](https://meta.discourse.org/u/Fraudoctor)
#### Post date: [January 11, 2021, 1:08am UTC](https://meta.discourse.org/t/featured-tiles/156677/21 "2021-01-11T01:08:11Z")

</div>

Agree. Still wondering if there is a work around to searching the entire topic for an image to use if one is there? Or will it ONLY take from the first post?

[Next page](https://meta.discourse.org/t/featured-tiles/156677.md?page=2)
