nav[aria-label="Primary Navigation"] { padding: 0; & ul { list-style: none; width: 100%; display: flex; flex-direction: row; justify-content: start; align-items: start; gap: 30px; padding: 0; & li { margin: 0; } & ul li { list-style: none; } } }

What is Carousel and how to use it in Confluence?

Anwesha Pan

✨ Let's enhance our Confluence content with Carousels for better readability and navigation.

Break up long, text-heavy Confluence pages for improved user experience and information retention. Carousels are an effective tool for achieving this.

📖 In this guide, we’ll talk through:

What is Carousel?
How to add the Carousel macro in Confluence
How to customize and configure your Carousel

What is Carousel?

The Carousel macro allows you to create a visually appealing and interactive image slider on your Confluence pages.

Recording 2025-08-14 125600.gif

📜Add Carousel macro in Confluence

Click the Edit icon (the pencil) on your Confluence page.
Start typing /carousel on your page, then click Carousel [Updated] in the dropdown.

Carousel macro.png

Upon selection, a carousel of three empty frames will appear on your page or doc.

📝Customize and configure Carousel

When you click on the Carousel macro, a sidebar will appear to let you customize each frame by : Style and Content
The Carousel editor shows you an interactive preview on the left and has additional options on the right. You can set :
- Layout
- Link/Button
- Title
- Description
- Image

Edit Carousel frame.png

3. Your selections will appear instantly.

4. Upon publishing your page, anyone with permission to view it will now be able to see your carousel, manually rotate through its frames, and navigate to any links provided.

Have your tried Carousel macro yet? What are your other favorite ways to make your Confluence pages more engaging? Let me know in the comments below! 👇

Comments

Kristian Klima_gtcuat

Thanks @Anwesha Pan

Will share this with our HR team as they're experimenting with Company Hub to make it their own... and I spotted a carousel on the top of the page.

Shame the macro is only available on Premium and Enterprise.

Mia Tamm _Simpleasyty_

This is a really clear and practical walkthrough, @Anwesha Pan — thanks for sharing!

I haven’t tried the Carousel macro yet, but I can see how it could make long Confluence pages feel more dynamic and engaging, especially for showcasing multiple related links or visuals in a small space.

— Mia Tamm from Simpleasyty

Anwesha Pan

Hi @Kristian Klima yes unfortunately it's only available on Premium and Enterprise.

But I hope your HR team is able to make it available for you as well so that you are also able to use it and enhance your Confluence page! ✨

Anwesha Pan

Hi @Mia Tamm _Simpleasyty_ 👋

Thank you so much for taking your time and going through this article. 😊 And I really appreciate your feedback. I hope you get to use this macro and experiment with the look and feel of your Confluence pages ✨

Veronika Chachkova I Stiltsoft

Hi everyone!

Carousel is 100% a great way to make Confluence pages more visual and user-friendly.

Just a note for anyone looking for the same experience on Data Center — the Handy Macros for Confluence app includes a Handy Carousel macro. It’s more flexible than the native Cloud version, gives you unlimited slides, layout controls, works in exports, and comes as part of a bigger toolkit (statuses, cards, buttons, etc).

Perfect when you want to build richer, interactive Confluence pages on DC.

Cheers,

Veronika from Stiltsoft

Welcome!

It looks like you're new here. Sign in or register to get started.

Quick Links

Find more posts tagged with

confluence

cloud

confluence-cloud

macro

atlassian-authors

new-to-confluence