# Bringing popular features to Discourse: Header search, welcome banner, and category icons / emoji
**URL:** https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169
**Category:** Announcements
**Created:** [April 2, 2025, 10:51pm UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169 "2025-04-02T22:51:29Z")
**Posts on this page:** 19
**Page:** 1
### Author:  [@lindsey](https://meta.discourse.org/u/lindsey)
#### Post date: [April 2, 2025, 10:51pm UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/1 "2025-04-02T22:51:29Z")
We have added several new features to Discourse based on popular [theme components](https://meta.discourse.org/t/customizing-your-site-with-existing-theme-components/312297) to make it easier to customize the design of your community. In this topic, we’ll share more about these new core features, how to use them, and provide information about they compare to the theme components that inspired them.
## Header search
The header search feature moves search from the magnifying glass in the top right corner to a more prominent input field in the site header.
When more header space is needed (such as when scrolling a topic), the search will revert to the magnifying glass to save room.
### To turn on header search…
1. In the admin area, go to **Themes & components**.
2. Click the Edit button for your active theme.
3. Find the `Search experience` setting.
4. Update this setting to “Search field in site header”.
5. Click the green check to save.
### Header search feature vs. Advanced Header Search component
Header search was inspired by the Header Search theme component, which we’ve renamed to [Advanced Header Search](https://meta.discourse.org/t/advanced-header-search/194093/) to distinguish it from the core feature.
You should use the Advanced Header Search component when you need to support external searches (i.e. searches outside of your Discourse community). Otherwise, you can use the header search feature that’s now part of Discourse core.
## Welcome banner
The welcome banner greets members and visitors and adds a prominent search bar to your topic lists.
The welcome banner and header search features are compatible with each other so that header search will be hidden while the welcome banner is visible.
### To turn on welcome banner…
1. In the admin area, go to **Themes & components**.
2. Click the Edit button for your active theme.
3. Find the `Enable welcome banner` setting.
4. Enable this setting.
5. Click the green check to save.
To customize the message displayed on the banner, go to the **Site Texts** area, and search for “welcome\_banner”. You can modify text strings for registered member greeting, anonymous user greeting, and search field.
### Welcome banner vs. Advanced Search Banner component
Welcome banner was inspired by the Search Banner component, which we’ve renamed to [Advanced Search Banner](https://meta.discourse.org/t/advanced-search-banner/122939) to distinguish it from the core feature.
You should use the Advanced Search Banner component when you want to use custom background images for the banner, enter multiple lines of text in the banner, or change who can see the banner (i.e. logged in members, logged out users, or both). Otherwise, you can use the welcome banner feature that’s now part of Discourse core.
## Category icons and emoji
You can now use icons and emoji to distinguish categories, instead of the colored square.
### To use category icons / emoji…
1. When creating or editing a category, change the **Style** setting to `Icon` or `Emoji`.
2. Choose the icon or emoji you want to use. The color will determine the icon color (if using) and impact other areas where a color is associated with the category, such as on the `/categories` page.
3. Click **Save Category**.
### Category icons and emoji vs. Category Icons component
Category icons and emoji were inspired by the [Category Icons](https://meta.discourse.org/t/category-icons/104683) component, **which we will soon be deprecating in favor of this core feature** because it supports more customization (i.e. emojis) and offers a much simpler setup experience.
For those currently using Category Icons, we recommend moving your icon customizations from Category Icons to the core category settings for longterm support and ongoing feature improvements. In our testing, the component settings override the core feature settings, but these were not designed to be used together.
---
### Author:  [@AquaL1te](https://meta.discourse.org/u/AquaL1te)
#### Post date: [April 3, 2025, 2:55pm UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/2 "2025-04-03T14:55:28Z")
I wanted to transition to the native category icon method. But I notice that the theme component has way more icons. Of all the icons I used, only a small subset is working now with the native category icons. I suppose the difference is that one uses FontAwesome and the other one emojis? I do use the option “icons” though, but when I search for them, they don’t show up (after disabling the theme component for category icons).
An example of what I use now:
---
### Author:  [@Arkshine](https://meta.discourse.org/u/Arkshine)
#### Post date: [April 3, 2025, 3:35pm UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/3 "2025-04-03T15:35:22Z")
You can add the missing icons to the `SVG icon subset` site setting.
---
### Author:  [@krystal](https://meta.discourse.org/u/krystal)
#### Post date: [April 3, 2025, 6:50pm UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/4 "2025-04-03T18:50:02Z")
> [@lindsey](#):
>
> You should use the Advanced Header Search component when you need to support external searches (i.e. searches outside of your Discourse community).
How does this work? 🤔 Does this mean you can search external sources while in Discourse? Or does this just mean searching Discourse from an external source?
---
### Author:  [@Heliosurge](https://meta.discourse.org/u/Heliosurge)
#### Post date: [April 4, 2025, 12:48am UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/5 "2025-04-04T00:48:15Z")
> [@lindsey](#):
>
> ## Category icons and emoji
>
> You can now use icons and emoji to distinguish categories, instead of the colored square.
>
> 
>
> 
This is quite awesome add! Thank you! Combined with custom emoji adds impressive customization capabilities!
---
### Author:  [@lindsey](https://meta.discourse.org/u/lindsey)
#### Post date: [April 4, 2025, 5:27pm UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/6 "2025-04-04T17:27:28Z")
3 posts were split to a new topic: [Bugs in creating or editing categories](https://meta.discourse.org/t/bugs-in-creating-or-editing-categories/360464)
---
### Author:  [@AquaL1te](https://meta.discourse.org/u/AquaL1te)
#### Post date: [April 4, 2025, 7:07am UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/7 "2025-04-04T07:07:47Z")
> [@lindsey](#):
>
> Category icons and emoji
There is still a difference though, with the theme component the subcategories get this nice touch:
This is not visible with the native category icon option. The top icon is then gone.
---
### Author:  [@tomtjes](https://meta.discourse.org/u/tomtjes)
#### Post date: [April 4, 2025, 7:50am UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/8 "2025-04-04T07:50:15Z")
I use category icons to indicate whether a category is public, visible to logged-in members, or limited to certain groups. Would this be possible to replicate with the new setting? I like that the icons are gray, but wouldn’t want to set all the category colors to gray.
---
### Author:  [@Arkshine](https://meta.discourse.org/u/Arkshine)
#### Post date: [April 4, 2025, 12:00pm UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/9 "2025-04-04T12:00:57Z")
> [@AquaL1te](#):
>
> This is not visible with the native category icon option. The top icon is then gone.
I think this will be supported once this PR is merged:
[https://github.com/discourse/discourse/pull/32109](https://github.com/discourse/discourse/pull/32109)
> [@tomtjes](#):
>
> I use category icons to indicate whether a category is public, visible to logged-in members, or limited to certain groups. Would this be possible to replicate with the new setting? I like that the icons are gray, but wouldn’t want to set all the category colors to gray.
It should be possible with CSS.
You could set the default color for all icons, and then, based on the `.anon` (for non-logged users) class and user’s group name (see [CSS Classes for Current User's Groups](https://meta.discourse.org/t/css-classes-for-current-users-groups/226068)), you can either hide the icon or change it to grey.
If you’re using only icons and the logged-in option is needed, it’s OK to keep using the TC, too.
---
### Author:  [@mcwumbly](https://meta.discourse.org/u/mcwumbly)
#### Post date: [April 5, 2025, 12:07pm UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/10 "2025-04-05T12:07:32Z")
> [@tomtjes](#):
>
> I use category icons to indicate whether a category is public, visible to logged-in members, or limited to certain groups.
I like this. I wonder if we should consider this a signal of something missing more fundamentally, rather than pushing this burden onto admins to solve with customizations.
Also related: [Allow users with access to a restricted category to see who else has access](https://meta.discourse.org/t/allow-users-with-access-to-a-restricted-category-to-see-who-else-has-access/20938)
---
### Author:  [@gooseegg](https://meta.discourse.org/u/gooseegg)
#### Post date: [April 6, 2025, 12:29pm UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/11 "2025-04-06T12:29:41Z")
Hi folks,
We recently upgraded our Discourse forum ([tw.forumosa.com](http://tw.forumosa.com)), and with the latest update, the new “Welcome back” header and integrated search bar were added to the homepage. While it looks fine in concept, we’ve noticed some usability issues — especially on mobile:
### 1. Search dropdown can be unreadable due to transparency
When tapping the search icon on the top nav bar (on Android, for example), the dropdown appears but has a transparent background, making it nearly impossible to read the search results over the content behind it. A solid background should solve this. I’ve posted screenshots of what I mean below.
### 2. Header is tall - how can we adjust the vertical spacing?
The new welcome message and search bar take up a big chunk of screen real estate on mobile. Since we already have the search icon in the nav bar, the added search bar feels redundant. We’d love to narrow the height of this header or hide the extra search bar/welcome message entirely on smaller screens.
This may affect desktop as well, but it’s especially problematic on mobile right now.
Has anyone come across this and found a clean way to override it via CSS or theme components?
Cheers!
 
---
### Author:  [@Arkshine](https://meta.discourse.org/u/Arkshine)
#### Post date: [April 6, 2025, 1:40pm UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/12 "2025-04-06T13:40:18Z")
Worth noting that the update banner stacks above as well:
It seems that the `z-index` on `.welcome-banner` (currently 1) should be at least \>= 3. (the main link and metadata uses `z-index: 2`)
---
### Author:  [@davidkingham](https://meta.discourse.org/u/davidkingham)
#### Post date: [April 10, 2025, 4:07am UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/15 "2025-04-10T04:07:04Z")
> [@Arkshine](#):
>
> I think this will be supported once this PR is merged:
I’m afraid it’s still broken 😥
---
### Author:  [@David\_Ghost](https://meta.discourse.org/u/David_Ghost)
#### Post date: [April 10, 2025, 10:43am UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/16 "2025-04-10T10:43:45Z")
You need to add the icons in `SVG icon subset`, if it’s not already done
---
### Author:  [@davidkingham](https://meta.discourse.org/u/davidkingham)
#### Post date: [April 10, 2025, 1:34pm UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/17 "2025-04-10T13:34:59Z")
Thanks, but I do:
---
### Author:  [@lindsey](https://meta.discourse.org/u/lindsey)
#### Post date: [April 10, 2025, 2:19pm UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/18 "2025-04-10T14:19:49Z")
Which page is this?
It looks like the icons are showing as expected on `/categories`, but not sure if that’s because you’re still using the theme component or if the issues you’re experiencing are on another page that we need to fix up.
---
### Author:  [@maiki](https://meta.discourse.org/u/maiki)
#### Post date: [April 19, 2025, 6:24am UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/20 "2025-04-19T06:24:46Z")
I just had a great experience: I switched to Horizon theme for my personal site, and set icons for my categories… from my mobile device!
That’s wild, and I appreciate the efforts going into making the admin experience this smooth.
😎👍
---
### Author:  [@tobiaseigen](https://meta.discourse.org/u/tobiaseigen)
#### Post date: [May 7, 2025, 3:00pm UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/22 "2025-05-07T15:00:45Z")
2 posts were split to a new topic: [Need help with switching to the new category icons](https://meta.discourse.org/t/need-help-with-switching-to-the-new-category-icons/365148)
---
### Author:  [@tobiaseigen](https://meta.discourse.org/u/tobiaseigen)
#### Post date: [May 7, 2025, 3:05pm UTC](https://meta.discourse.org/t/bringing-popular-features-to-discourse-header-search-welcome-banner-and-category-icons-emoji/359169/23 "2025-05-07T15:05:34Z")