Configuring the home page banner

The home page banner lets you show an announcement at the top of the Rencore Teams App home page. Use it to tell new users what the app is for, point them to a walkthrough, or share a governance update.

Each user sees the banner until they interact with it. After that, it stays hidden for them until you choose to show it to everyone again.

Set up the banner

To set up the banner, you will need to:

1. Click on “Settings”.
2. Click on “Teams App Settings”.
3. Click on “Homepage”.
   
4. Turn on “Display announcement banner”.
5. Enter a “Headline”.
6. Enter a “Message”.
7. Optionally, enter a “Button label” and a “URL” for the link button.
   
8. Click “Save”.

Saving the banner settings writes an entry to the audit log.

Banner fields

Field	Rules
Headline	Plain text, up to 80 characters. Required while the banner is turned on.
Message	Up to 800 characters, with a character count. Supports bold, italic, underline, strikethrough, lists and inline links. Text color, background and border formatting are not available. Required while the banner is turned on.
Button label	Up to 30 characters. Optional.
URL	Must start with http:// or https://. Optional.

While the banner is turned off, you can save an incomplete draft. Headline and Message are only required once you turn it on.

The link button follows these rules:

• A URL without a label cannot be saved. Add a label or remove the URL.
• A label without a URL is saved, but no button is shown.
• Any URL that does not start with http:// or https:// cannot be saved.

What users see

When the banner is turned on, users who have not interacted with it see it on the home page, below the greeting. When it is turned off, nobody sees it.

Users can interact with the banner in three ways:

• “Got it” hides the banner straight away.
• The X hides the banner straight away.
• The link button opens the URL in a new browser tab. The banner stays visible until the user clicks “Got it” or the X.

Any of the three counts as that user’s single interaction with the current banner. Once a user has clicked “Got it” or the X, the banner stays hidden for them across visits, sign-ins and app restarts. Other users are not affected.

The banner works in the light, dark and high-contrast Teams themes, on Teams mobile, and in a narrow window.

Change the banner

Editing the Headline, Message or link button does not show the banner again to users who have already interacted with it. Turning the banner off and on again does not either.

After you save a content change, a notice reminds you of this and offers “Show to everyone again”.

Show the banner to everyone again

To show the banner again to every user, you will need to:

1. Click on “Settings”.
2. Click on “Teams App Settings”.
3. Click on “Homepage”.
4. Click “Show to everyone again”.
5. Confirm the action.

This takes effect immediately and does not need “Save”. It resets every user’s interaction, so all users see the banner again on their next visit, and it sets the interaction count back to zero. It also writes an entry to the audit log.

Interaction count

The interaction count is shown next to “Show to everyone again”, as “N users interacted with the current message”. It is the number of users who have clicked “Got it”, the X or the link button since the banner was last reset.