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.

What a banner can look like
Section titled “What a banner can look like”Each classification level has its own banner, designed by an admin in the Banner Studio. The background is one of:
| Background | What page readers see |
|---|---|
| Colour | A solid colour band, in the level’s colour or a custom colour. |
| Gradient | A two-colour gradient. |
| Preset | One of the built-in background images. |
| Upload | The 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.
Banner size
Section titled “Banner size”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.
| Size | Height | Choose it when |
|---|---|---|
| Small | 80px | You want the lightest possible footprint on the page. |
| Medium (default) | 160px | The general-purpose choice. |
| Large | 240px | You want the banner to be unmissable. |
| Auto | Grows to fit the description | Your 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.
Auto size
Section titled “Auto size”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.
How the banner text fits
Section titled “How the banner text fits”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.
Where the banner appears
Section titled “Where the banner appears”- 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:
- Did you refresh? The banner appears on page reload after classifying.
- 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.
- 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:
- Open the level in Space Settings.
- Click Open banner designer. The studio shows “Text is part of the image”.
- Choose a background: a colour, a gradient, a preset or an uploaded image.
- Click Apply, then Save Changes.
Levels with a colour banner were never affected and need no action.
Related
Section titled “Related”- Classifying a Page — how to apply a level.
- Banner Studio — where each level’s banner is designed.
- Space Settings — classification levels and the space’s banner size.