# Advanced Search Banner

**URL:** https://meta.discourse.org/t/advanced-search-banner/122939
**Category:** Theme component
**Tags:** official, deprecated, search-banner, advanced-search-banner
**Created:** [7월 15, 2019, 3:49오전 UTC](https://meta.discourse.org/t/advanced-search-banner/122939 "2019-07-15T03:49:07Z")
**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/148734_2.png) [@Discourse](https://meta.discourse.org/u/Discourse)
#### Post date: [7월 15, 2019, 3:49오전 UTC](https://meta.discourse.org/t/advanced-search-banner/122939/1 "2019-07-15T03:49:07Z")

</div>

> ⚠
> 
> This theme component is deprecated and should no longer be used. Its features are now in Discourse Core — see our documentation for details on setting up a welcome banner:
> 
> → [Creating a banner to display at the top of your site](https://meta.discourse.org/t/creating-a-banner-to-display-at-the-top-of-your-site/153718#p-762961-welcome-banner-1)

| | | |
| --- | --- | --- |
| :discourse2: | **Summary** | **Advanced Search Banner** puts a search bar along with optional headline and subhead text in a banner above the main topic list navigation. |
| 👓 | **Preview** | [Preview on Discourse Theme Creator](https://discourse.theme-creator.io/theme/Discourse/search-banner) |
| 🛠 | **Repository Link** | [https://github.com/discourse/discourse-search-banner](https://github.com/discourse/discourse-search-banner) |
| 📖 | **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. 👍
> 
> [❓ **Support**](https://meta.discourse.org/new-topic?category_id=6&tags=search-banner "Ask for support on configuring and using Search Banner") [🐛 **Bug**](https://meta.discourse.org/new-topic?category_id=1&tags=search-banner "A bug report means something is broken, preventing normal/typical use of the theme component") [👀 **UX**](https://meta.discourse.org/new-topic?category_id=9&tags=search-banner "Discussion about the user interface of Search Banner, and how features are presented (including language and UI elements)") [💡 **Feature**](https://meta.discourse.org/new-topic?category_id=2&tags=search-banner "Discussion about how existing Search Banner features can be improved or enhanced, and how proposed new features could work")

### Features

By default, this banner appears on all top-level topic pages (latest/new/unread/top/categories… anything in the `top menu` site setting) but it can also be set to only display on a community’s homepage.

 ![search banner example](https://global.discourse-cdn.com/meta/original/3X/1/4/14ec7e5d17d7b8bd203759ce1c9b69605e2d9e03.png)

### Settings

| Name | Description |
| --- | --- |
| show on | This determines which pages the banner appears |
| plugin outlet | Where on the page the banner will appear |
| background image light | Background image for the banner on light color palettes |
| background image dark | Background image for the banner on dark color palettes |
| tile background image | Repeat the background image |
| show for | Who can see the Search Banner (logged in, logged out, or both) |
| special style | Optional variations that change the appearance of the search banner |

| Translation | Default |
| --- | --- |
| search\_banner.headline | Welcome to our community |
| search\_banner.subhead | We’re happy to have you here. If you need help, please search before you post. |
| search\_banner.search\_button\_text | |

To omit one from display, leave the field blank.

### Custom styling

The HTML element gets a class named `.display-search-banner` wherever this banner appears, and the banner itself is wrapped with the `.custom-search-banner` class, so with some CSS you should be able to customize the appearance of this banner however you see fit.

### Future enhancements

- Add an option to enable the banner in specific categories

### Credits

💖 This very heavily borrows from @angus’ [Pavilion Header Search Theme Component](https://meta.discourse.org/t/header-search-theme/67959)

  

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

> Last edited by @lindsey 2025-12-18T18:26:57Z
> 
> > **Check document**
> >
> > Perform check on document:

---

_[View the full topic](https://meta.discourse.org/t/advanced-search-banner/122939)._