Skip to content

Page Banner

When a page is classified, a visual banner can appear at the very top of the page. It is the most visible signal of a page’s sensitivity — page readers see it before any content.

The banner is controlled by the classification level, so what it looks like depends on how your space admin configured that level’s page header style.

A Confluence page showing a visible classification banner at the top of the page.
A Confluence page after a classification banner is applied.

Each classification level has its own banner, designed by an admin in the Banner Studio. The background is one of:

BackgroundWhat page readers see
ColourA solid colour band, in the level’s colour or a custom colour.
GradientA two-colour gradient.
PresetOne of the built-in background images.
UploadThe organisation’s own image, cropped around a chosen focal point.

The level name and description appear on top, in the position, size and text colour the admin chose. On an image, a semi-transparent overlay can sit behind the text to keep it readable.

A level can also have no banner. The byline dot still shows the level.

Space admins design banners for their space’s levels in Space Settings. Confluence admins design them for global templates.

The banner’s height is a space-wide setting with four options. All image and colour banners in the space use the same size. Space admins set this in Space Settings → Header image size.

SizeHeightChoose it when
Small80pxYou want the lightest possible footprint on the page.
Medium (default)160pxThe general-purpose choice.
Large240pxYou want the banner to be unmissable.
AutoGrows to fit the descriptionYour level descriptions are long and you want all of the text to be readable.

A Confluence admin can also set the size on a global template, which applies it across every space the template reaches. This is the way to change the banner height for a whole Confluence site without opening each space.

Small, Medium and Large are fixed heights. The banner is always exactly that tall, and the text is sized to fit inside it.

Auto works the other way round. The text stays at its configured size and the banner grows to fit it. A short description produces a banner no taller than Small; a longer one gets as much height as it needs, up to a limit of 320px.

Choose Auto when your classification descriptions are a full sentence or more and you would rather not have them shrink.

The level name and description are drawn as real text on top of the banner, and Classify works to keep them readable for page readers:

  • At a fixed size, the text is measured against the space available and scaled down until the description fits, so a long description shrinks instead of being cut off. There is a lower limit on how small the text will go; beyond that point a very long description is shortened. As a guide, a Small banner shows around 460 characters, and Medium and Large around 610.
  • At Auto size, nothing shrinks. The description is shown at its configured size, up to roughly 1,200 characters.
  • The banner also re-fits when the browser window is resized, so the text stays readable in a narrow window as well as a wide one.
  • Line breaks typed in a level’s description are kept, so a description can run over several lines. Blank lines at the start and end are ignored.

Admins set the text size for each classification level in the Banner Studio. The studio shows the size each choice actually produces at the space’s current banner size, because a Small banner has far less room than Auto.

  • On regular pages and blog posts that have been classified.
  • It does not appear on Confluence space-settings or admin pages, even though those technically have a page context. This is intentional, to avoid showing the banner where it does not belong.

I classified a page but do not see a banner

Section titled “I classified a page but do not see a banner”

Check these in order:

  1. Did you refresh? The banner appears on page reload after classifying.
  2. Does the level have a banner? If the level’s Page Banner is set to None, there is no banner by design — only the byline dot.
  3. Does the level have a background? A level with no background chosen has no banner. Ask your space admin to open the level in the Banner Studio and choose one.

See FAQ for more.

The banner text does not resize, or appears twice

Section titled “The banner text does not resize, or appears twice”

Banner text used to be painted permanently into the header image. It is now drawn as live text on top of the image, which is what makes the automatic fitting and the per-level banner text sizes possible.

Classification levels whose header image was created before this change keep their original banner exactly as it was. The text is still part of the image, so it will not resize and the text settings have no effect on it.

A space admin converts such a level by choosing a new background:

  1. Open the level in Space Settings.
  2. Click Open banner designer. The studio shows “Text is part of the image”.
  3. Choose a background: a colour, a gradient, a preset or an uploaded image.
  4. Click Apply, then Save Changes.

Levels with a colour banner were never affected and need no action.