Skip to content

Banner Studio

The Banner Studio is a full-screen designer for the visual banner of a classification level. You choose the background, place and size the text, and check that the result is readable, with a live preview of the banner as page readers will see it.

The studio is available wherever classification levels are edited:

  • Space Settings, for a space’s own levels. You need to be a space admin.
  • The global template editor, for the levels of a global template. You need to be a Confluence admin.
The Banner Studio open on a Confidential classification level, with the background options on the left, a live preview of the banner on a sample page in the centre, and the text position and text size controls on the right.
The Banner Studio: background on the left, live preview in the centre, text settings on the right.
  1. Open a classification level for editing in Space Settings or in a global template.
  2. In the Page Banner section, choose Show banner.
  3. Click Open banner designer.
  4. Design the banner, then click Apply.
  5. Back in the level form, click Save Changes.

Cancel closes the studio without changing anything.

The Page Banner section of the level form shows:

  • A preview of the banner.
  • A one-line summary, for example Gradient · Text on the left · Contrast 7.1:1.
  • None or Show banner. None turns the banner off for this level. The byline dot still shows the level.
  • Open banner designer and Remove.

The left panel sets what is behind the text. Choose one of four sources:

SourceWhat you get
ColourA solid colour band. Use the level colour or pick a custom colour.
GradientA two-colour gradient with a start colour, an end colour and an angle.
PresetOne of the built-in background images. No upload needed.
UploadYour own image, in JPEG or PNG format.

Tint by level colour is available for Colour and Gradient. When it is on, the colours come from the level’s own colour, so every level that uses this style shows its own colour.

For an uploaded image you can also set:

  • Focal point — click the part of the image that must stay in view. The banner is wider and shorter than most photos, so the image is cropped to fit. The focal point decides which part is kept.
  • Zoom — from 100% to 250%.

The image is stored when you click Apply. A very large or detailed image is compressed. If it is still too large after compression, the studio asks you for a smaller or simpler image.

Replace chooses a different image. Remove clears it.

The right-hand panels control the level name and description on the banner.

Choose one of nine positions: top, middle or bottom, each on the left, in the centre or on the right. Until you choose one, the text sits on the left.

SettingRangeDefault
Level name16–7242
Description10–3220

These are design sizes, not final pixel sizes. Under each slider the studio shows the size the text really has on the space’s current banner size. A Small banner has little room, so a large value may have no visible effect there. The studio tells you when this happens.

You can also choose Light text or Dark text, and turn on a Text shadow.

Image backgrounds only. A semi-transparent layer between the image and the text makes the text easier to read:

  • Flat — an even layer over the whole banner.
  • Left fade — strongest behind the text on the left, fading out to the right.
  • Bottom fade — strongest at the bottom, fading out upwards.

Opacity sets the strength, from 0% to 80%. With dark text, the overlay is light instead of dark.

The Contrast panel estimates how readable the text is against its background. It shows the contrast ratio and whether it passes WCAG AA for small text (4.5:1). WCAG is the web accessibility standard that most organisations follow.

If the other text colour reads better, a button such as Use dark text (8.2:1) switches to it in one click.

The check is a guide only. It never stops you from applying a design.

The centre of the studio shows the banner on a sample Confluence page, using the same component that draws the banner for page readers.

  • Wide page and Narrow page show the banner at two page widths. The text fits differently on a narrow page.
  • A status shows how the text fits: Everything fits, Text reduced to fit, Text held at minimum size, or Description cut off.
  • Preview at every size shows the banner at Small, Medium, Large and Auto side by side, with the text size each one produces.

Click a size card to preview the banner at that size. What happens on Apply depends on where you opened the studio:

Opened fromClicking a size card
Space SettingsSets the banner size for the whole space. It applies to every level.
Space Settings, when the global template sets the sizePreview only. The template decides the size. To override it, use Header image size in Space Settings.
Global template editorSets the template’s banner size. Not set lets each space keep its own size.
  • Undo and Redo step through your changes. You can also use Ctrl+Z and Shift+Ctrl+Z.
  • Reset to defaults restores the default text and legibility settings. The background is kept.

Nothing is saved until you click Apply, so you can experiment freely.

Existing banners are not changed by the Banner Studio. A level keeps exactly the banner it had until an admin changes it and saves the level.

When you open such a level, the studio shows a note: “Created with the previous editor. It opens exactly as page viewers see it, and nothing about it changes unless you change it here.”

Two older cases have their own behaviour:

  • Text inside the image. In the first version of Classify, the level name and description were painted into the header image. The studio shows “Text is part of the image” and holds back the text, position, overlay and contrast controls, because that text cannot be changed. Choose a new background to convert the level to live text.
  • A custom dragged position. A text position dragged in the previous editor is kept and shown as Custom (previous editor). It stays until you choose one of the nine positions.