• Products
  • Documentation
  • Resources

Post Confluence-wide announcements in a banner

The banners feature is a premium admin tool available to Confluence administrators with a Premium and Enterprise plan.

An announcement banner provides a way for Confluence product administrators to quickly communicate important information to everyone in Confluence.

The custom message gets pinned to the very top of the Confluence instance — a prominent place to announce things like:

  • Time-sensitive alerts

  • Software updates

  • Planned maintenance

  • etc

Confluence announcement banner published

When creating or editing a banner, Confluence administrators can control the message, color, Start and End dates, whether the banner is limited to internal licensed users (private) or also visible to external audiences (public) — and whether or not viewers can dismiss it.

The Banners feature is located in Confluence administration.

Banners aren’t available as a space-level feature.

 

Manage banners

The landing screen contains the announcements table. This table maintains a record of all the announcement banners ever created.

It shows each banner’s title, publication state (Status), whether it is (or was) visible to a public or private audience, and the dates that it ran (or will run). An Actions column provides options for managing the banners, by either editing, archiving, or copying them.

Each banner exists in an Active, Scheduled, or Archived state.

Only one banner can be Active at a time. Banners with a past End date show as Archived. Banners with a future Start date show as Scheduled.

If a banner is shown as Active, it is currently visible to viewers.

Active and Scheduled banners can be edited or archived by clicking the appropriate icon in the table.

Archived banners can be copied into a new banner, making it easy to repurpose prior messaging.

Announcements table shows 3 banners in Active, Scheduled, and Archived states. A Create Announcement button is top-right.

 

Create announcement banners

Announcement banners can contain a custom message of up to 4,000 characters. The look and feel of a banner is customizable via color selection. Other configuration, like Audience and Scheduling, impacts who sees the banner and when.

Configuration options

  • Color

    • Colors can communicate different message tones. For example:

      • Gray – General (default)

      • Blue – Informational

      • Purple – Note

      • Green – Success

      • Yellow – Warning

      • Red – Emergency

  • Toggle (OFF – Static, ON – Dismissable)

    • This controls whether viewers can close the banner or not. The toggle is OFF (static) by default.

  • Target audience

    • Public: This allows anyone who can view Confluence to see the banner — guest users, anonymous access, etc. — in addition to internal licensed users

    • Private (default): This limits banner visibility to internal licensed users, only

  • Schedule

    • Scheduling specific Start and End dates and times will automatically control when a particular banner is Active and visible — but it’s not required

Banners are designed to Start as soon as they’re published, and to run indefinitely or until archived.

Although only one banner can be Active at a time, scheduling additional banners can be useful for setting up a queue of banners to run in succession.

Publication options

  • Publish without a schedule

    • This activates the banner immediately, and leaves it on indefinitely

      • The banner remains visible unless a Confluence administrator archives it, or unless a scheduled banner replaces it

  • Schedule an End date, but no Start date

    • This activates the banner immediately, but determines when it should “turn off”

      • When the End date arrives, the banner automatically moves to an Archived (inactive) state

  • Schedule future Start and End dates

    • This delays activation of the banner until a future date and time

      • When the Start date arrives, the banner automatically moves to an Active state — and bumps any existing Active banner to an Archived (inactive) state

      • When the End date arrives, the banner automatically moves to an Archived (inactive) state

Scheduled banners always require an End date.


To publish a new banner:

  1. Verify that you are logged in as a Confluence administrator.

  2. Select the wheel icon () in the top-right corner to open Confluence administration.

  3. Find Admin tools in the left-hand navigation.

  4. Select Banners.

  5. Select the Create announcement button.

  6. Enter a title for your banner.

  7. Configure the required display settings which include:

    1. Message (up to 4,000 characters)

    2. Color

    3. User toggle on/off (to dismiss the banner)

    4. Target audience (public or private)

  8. (optional) Enter an End date (if you want the banner to auto-archive).

  9. Select Publish.

Hyperlinks can be used in the message. Bulleted lists, line breaks, and code blocks can not.


To schedule a new banner:

Scheduling follows the same process as publishing a new banner, but requires Start and End dates.

  1. Follow steps 1 – 7, above.

  2. Enter future Start and End dates.

  3. Select Publish.

Confluence announcement banner setting


To re-publish an Archived banner:

  1. (Navigate to Banners)

  2. In the announcements table, locate the title of the Archived banner you want to re-publish

  3. Click the copy icon in the Actions column

    1. This will open a new Create announcement configuration screen, with the copied information pre-populated

  4. (Optional) Adjust the title, display settings, audience, and/or schedule as needed

  5. Select Publish

The copied banner will appear in the announcements table as a new banner in a new row because it will, at a minimum, have a unique Start and End date. This serves to preserve a record of each time the banner ran.

 

Edit announcement banners

Active and Scheduled banners can be edited. Changes will be reflected in the Confluence audit log.

Archived banners can’t be edited since they capture a moment in time.

To edit an Active or Scheduled banner:

  1. Verify that you are logged in as a Confluence administrator

  2. Select the wheel icon () in the top-right corner to open Confluence administration.

  3. Find Admin tools in the left-hand navigation.

  4. Select Banners.

  5. In the announcements table, locate the title of the banner you want to edit.

  6. Click the edit icon in the Actions column.

    1. This will reopen the configuration screen as Edit announcement

  7. Adjust the title, display settings, audience, and/or schedule as needed.

  8. Select Update.

Configuration screen for Edit announcement

Archive announcement banners

Archiving a banner is essentially turning it “off” or inactivating it. Both Active and Scheduled banners can be archived. Unlike archiving pages or whiteboards, archived banners do not move to the Confluence archive. They remain in the announcements table, but their Status transitions to an Archived state. Changes will be reflected in the Confluence audit log.

There are four ways to archive a banner:

  • Auto-archive a banner by scheduling an End date.

  • Auto-archive a banner by scheduling a new banner to replace it.

  • Manually archive a banner by selecting its archive icon in the announcements table.

  • Manually archive a banner by selecting the link at the top of a banner’s Edit announcement screen.

Still need help?

The Atlassian Community is here for you.