Banner
A full-width photo banner or rotating carousel, each slide carrying a headline, a line of body text and an optional button.
Use Banner for the hero strip at the top of a space home page, a landing page or an onboarding page, the thing a reader sees first. Each slide is a photo with a headline, a short paragraph and an optional call-to-action button that links to a Confluence page or an external URL. With one slide it is a static hero; with several it becomes a carousel with arrows, dots and optional auto-advance. It is a standalone block: you configure it entirely in its own panel rather than typing into it on the page.
Type | Stands on its own |
|---|---|
PDF and Word export | See below |
Published Capable Site | Supported |
Name in the picker | Banner (Capable) in the suite. The standalone app usually adds the word macro. |
#See it
Every example below is a real macro on this page, not a screenshot, and each one is a configuration taken from a page somebody actually built. Open this page in the editor to see how any of them is set up.
#3 slides, with images: Confluence is better with Capable
#3 slides, auto-scrolling, with images: Introducing the new experience
#With images: New here? Start with the guide
#With images: Welcome to the program hub
#Settings
The configuration panel has two tabs. Content holds your slides, one expandable row each. Style holds the look of the whole banner: corners, shadow, border, overlay and button fill.
Setting | Values | What it changes |
|---|---|---|
Slides | A list. Each slide is an expandable row you can drag by its grip handle to reorder, and delete with the bin icon. The Add Slide button adds a new slide, pre-filled with one of three sample slides picked at random. | Each slide becomes one panel of the carousel, in list order. |
Title | Free text. Required. | The slide's large headline. Long titles wrap onto the next line rather than being cut off. |
Body | Free text. Required. Line breaks you type are kept on the page. | The paragraph under the headline, shown slightly transparent. |
Image URL | An image URL, a Confluence attachment, or empty. The field is labelled "Image" and opens the same picker as elsewhere (attachments, pasted URL, Unsplash search). | The slide's background photo, sized to fill the slide. |
Image Alt Text | Free text. | Describes the slide photo for people using screen readers. |
Button Text | Free text. | The label on the slide's call-to-action button. Leave it empty and the button is hidden, whatever link you set. |
Link Type | URL, Page or None, shown as a compact icon dropdown labelled "Type". | Chooses where the slide's button goes. Page swaps the next field for a Confluence page picker and clears any URL. URL clears any page and shows a URL box. None shows the text "No link" and hides the button. |
Link URL | Any URL. The field is labelled "URL" and only appears when Link Type is URL. | Where the button opens. |
Page ID | A Confluence page, chosen by typing its name in a picker. The field is labelled "Page" and only appears when Link Type is Page. | The button opens that Confluence page. |
Text Color | A brand colour (Text role) or custom, with a clear button. The hint in the panel reads "Overrides the automatic light/dark text. Clear to pick automatically from the image." | Sets the colour of the slide's title, body and button label. Cleared, the macro checks how bright the slide photo is and picks white or black. |
Auto scroll | On or off | When on, the carousel moves to the next slide by itself. Has no effect when the banner has only one slide. |
Auto scroll interval (seconds) | 2 to 60, whole seconds. The field is labelled "Interval (seconds)" and only appears when Auto scroll is on. | How long each slide shows before moving on. |
Corner radius | 0 to 24 pixels | Rounds the corners of the whole banner, and the slides and photos follow the same shape. |
Shadow | None, S, M, L | Adds a drop shadow under the banner. |
Border | Off or on. When on, a Width slider (0-6px) and a colour picker appear. | Draws an outline around the banner. |
Overlay opacity | 0 to 1, in steps of 0.05 | How strong the dark (or tinted) wash over each slide photo is at its strongest point. The wash is a gradient: full strength at the bottom of the slide, a sixth of that at the middle, and clear at the top. Set it to 0 to remove the wash entirely. |
Overlay colour | A brand colour (Background role) or custom. The hint in the panel reads "Gradient tint over each slide image, strongest at the bottom and fading out towards the top." | The colour of that wash. It also becomes the solid fill for any slide whose photo cannot be shown. |
Button fill | A brand colour (Accent role) or custom, with a clear button. The hint in the panel reads "Fill colour for slide buttons. Leave unset to match the slide's automatic light/dark button." It applies to every slide's button, not one slide at a time. | Sets one background colour for all slide buttons. The label uses the slide's Text Color if set, otherwise a colour that stands out against the fill. Left unset, each button picks a light or dark style to suit its own slide. |
#Related
Give the eye somewhere to land.
