Note
We are planning to deprecate support for this theme component soon and advise you to use the welcome banner feature instead.
 |
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 |
 |
Repository Link | https://github.com/discourse/discourse-search-banner |
 |
New to Discourse Themes? | Beginner’s guide to using Discourse Themes |
Install this theme component
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.
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
Last edited by @lindsey 2025-08-11T15:36:57Z
Check document
Perform check on document: