Welcome Link Banner

:discourse2: Summary Welcome Link Banner is a simple banner, similar to the one in use here on Meta, that allows you to add some custom text and 1-4 links.
:eyeglasses: Preview Preview on theme-creator.discourse.org
:hammer_and_wrench: Repository Link https://github.com/discourse/discourse-welcome-link-banner
:open_book: New to Discourse Themes? Beginner’s guide to using Discourse Themes

Install this theme component

This component comes with a variety of settings!

Name Description
show on Choose to show your banner on the homepage, topic lists, or all pages
banner links Add 1-4 links with font awesome icons and text (you might also need to add icons that aren’t included in Discourse by default to the svg_icons setting)
max trust level Only show the banner to users at specific trust levels
hide for staff
hide on mobile
layout Text-left (default) or text-top
plugin outlet allows you to change where the banner is rendered, if you’re using the sidebar try above-main-container
hide for anon Hides the banner from logged-out users
can be dismissed Allows users to click an x to hide the banner
banner background image Choose an image to display behind the banner
banner background repeat Configure background image repeat behavior
banner background size Adjust your background image size using CSS (more info)
banner background color No background image? Use a solid color!
banner box background color
banner text color
banner icon color
banner link color

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


If you’re using the experimental sidebar, I’ve added a setting (plugin outlet) that will make the welcome banner appear above the content but not above the sidebar. Just change that setting to above-main-container.

Changing that setting will make the banner appear to the right of the sidebar, as our banner does here on Meta:


10 posts were split to a new topic: Welcome Link Banner no longer showing on my site?

Question: when a user (me ^^) has closed the banner, how can he recover it ?
I do ctrl+F5 but it won’t come back, and I closed it just for test.


On desktop, you can clear the localstorage item here, discourse_dismissedWelcomeLinkBanner.

You hit F12 to open the browser console → go to Application tab → In the left panel, click on Local Storage then your website → Look for the discourse_dismissedWelcomeLinkBanner key and delete it.

That’s it! You can refresh, and the banner should appear again.


Is there a way to display the banner if a user is in, or not in a group? rather than based on trust levels?


Hi @martyn_thomas :wave: If you install this theme component you should be able to use CSS to achieve what you want


My question may seem stupid, but I’m not a programmer. I installed the CSS Classes for Current User's Groups component. If I want to display 3 banner options for three different groups, should I install three copies of the Welcome Link Banner component? Then how should I style the CSS if I want to:
For group A, banner-A was displayed, for group B, banner-B was displayed, and for group C, banner-C was displayed? Could you give an example?
Thanks in advance for your answer :pray:


Only install one copy of the component. See here for how to use

body.group-(group name here) .welcome-link-banner-wrapper {
    display: none;

replace “(group name here)” with the group you want to hide banner for.


Thanks, this works if I want to hide a banner for a specific group, but I don’t know how to display different banners with different content for different groups(


if you want different banners, that is going to required more than one copy of the welcome link banner component (not the css group component). You may also want to do different CSS to show rather than hide.


I understand this, but I don’t know how to implement such CSS. I need a rough CSS example


you may want to hide it for everyone first, then use display: block for select groups. What you are wanting can likely be achieved more than one way - hiding for all then showing for some, or hiding for some.

1 Like

Allow me to offer some clarifications.

If I have several copies of a component, how should I write the class name. For example,

body.group-name1 .welcome-link-banner-wrapper 1{
display: none;
body.group- name1 .welcome-link-banner-wrapper 2 {
display: none
body.group-name2 .welcome-link-banner-wrapper 1{
display: block;
body.group-name2 .welcome-link-banner-wrapper 2{
display: none
body.group-name3 .welcome-link-banner-wrapper 2{
display: block

Something similar to?
I can’t figure out what .welcome-link-banner-wrapper will be called for each component instance.


You may have to fork the banner component for each use? probably best to learn some basic CSS and theme component dev for this sort of out of scope use case.


I would like to use this banner because it is simple and clean. Is it OK to use it to promote my company’s app rather than as a welcome banner?

I’m thinking of setting the link to a URL that can be downloaded from the App Store. Is there any problem with this as well?

Can I change the “Welcome to our community!” part?


Yes you can customize all the texts, choose the icons and add whatever links you want to add.
You can also try the theme on theme creator





3 posts were split to a new topic: What icons can I add the Welcome Link Banner?


I want to hide the Welcome Banner in the Category Pages (/c/xxx or /c/yyy). Is there any way to set this as a parameter?