Confluence Essentials
Confluence Cloud Best Practices
.svg?cb=de4c4813284972f3a2aa9512cc943b23)
Confluence Use Cases
Confluence News
Documentation Guide
#81 - Three Top Tips for the Tippy-Top of Your Next Confluence Page
Matt Reiner
In this issue we explore three crucial elements for the top of any effective Confluence page and share the announcement that the legacy editor is leaving Confluence Cloud in early 2026.
Make the Top of Your Confluence Page Work for Everyone
The top of a Confluence page is prime real estate. It’s the first thing people see when they land on a live-doc or page and often the only thing they read before deciding whether to keep scrolling or click away. That makes it the perfect place to show readers: Yes, this page has what you’re looking for.
Luckily, Confluence gives you plenty of simple tools to make that happen.
Emoji and Banner: Small Details, Big Signals
Really quick; start with an emoji. It’s not just decorative, it acts like a visual cue so readers can:
Quickly scan the content tree and get an idea of what the page is about before they even open it
Get a signal on the purpose of the live-doc in a snap
Next, add a page banner.
You can use this space to reinforce the purpose of the page, whether it’s part of a larger project, a recurring type of content, or something that needs to stand out. It’s a small touch that can go a long way toward clarity and consistency.
Write a Short Description That Says It All
Every Confluence page should start with a short description. Just a sentence or two. It should explain the purpose of the page and give readers a quick idea of what they’ll find. Think of it as a mini elevator pitch for the content below.
Remember: This might be all they read on the entire page, so make it count!
A good way to add this description is to use the Excerpt macro. That lets you reuse the same description on overview pages, in macros, or wherever you want to preview the content.
Pro Tip: If you use Rovo, you can quickly generate a first draft of your page summary using AI, then edit it to match your voice.
Use the Table of Contents Macro to Make Navigation Easier
If your page includes multiple headings, especially longer ones, add a Table of Contents (TOC) macro near the top. This helps readers scan and jump to what they need without scrolling forever.
The TOC macro is more flexible than it looks:
You can style it vertically or horizontally.
You can adjust which heading levels it shows. 1 for live-docs with lots of headings, 😉
You can add section numbers for step-based structure.
Pro Tip: Add related links nearby. Think about what else someone might need after reading your page. Are there related docs? Background info? Templates? Add those links near the top, near the TOC.
Great Page Top, Great Page
A thoughtful page top helps your content do its job. Use the tools Confluence gives you, like emoji, banners, short descriptions, and the TOC, to guide your readers, make things easier to understand, and show that your team knows how to make content work. Want to learn even more about how to make your page effective?
Confluence News
Bye Bye Legacy Confluence Editor
Well, it’s finally that time. For those of you who migrated from Confluence Server or Data center, Atlassian has announced the deprecation of the Legacy Editor in Confluence Cloud. The process will take place between January and April 2026.
