Skip to main content
How to add extra information with a Confluence pop-up dialog
Share on socials

How to add extra information with a Confluence pop-up dialog

A headshot of Zoriana Bogutska
Zoriana Bogutska
22nd March, 2024
A document popping out of a box with a wind-up handle against a stylised background
A headshot of Zoriana Bogutska
Zoriana Bogutska
22nd March, 2024
jump to section
Why use a pop-up in Confluence?
How to add a Confluence pop-up dialog

Clean pages without the compromise - that’s what you get with a Confluence pop-up. Give users all the information they want, all in one place.

Giving users all the context they need is important, but sometimes all that information can be overwhelming. Thanks to Confluence pop-ups, you can make sure that users don’t miss out.

This guide is for providing users with non-urgent information. If you'd like to learn to add an automatic pop-up warning to your page, read our guide on how to create Confluence alerts.
A GIF of a user clicking a Confluence pop-up to view installation requirements

Why use a pop-up in Confluence?

  • It’s a great way to allow users to opt-in to the information they’re interested in.
  • It allows for adding extra information to your page without adding clutter.
  • It means that you can keep all of your information on one page - no need for users to open up new tabs.

How to add a Confluence pop-up dialog

As Confluence doesn’t include a built-in pop-up macro, you’ll need an app from the Atlassian Marketplace.

  1. Install Content Formatting Macros for Confluence (it’s free for 30 days).
  2. Go to the page you'd like to add a pop-up dialog to. Click the pencil ‘Edit’ icon.
  3. Click where you’d like the trigger for the pop-up to appear. Start typing /popup and select the ‘Pop-up Dialog’ macro.
Screenshot of the keyboard shortcut for the Pop-up Dialog macro for Confluence
4. This will bring up the Pop-up Dialog editor. Here, you can customise your dialog:
  • Add a title to your pop-up dialog
  • Choose the width of the dialog
  • Select the alignment of the text within the dialog
The Pop-up Dialog editor in Confluence with customisation options
5. Now click ‘Add pop-up trigger’. A trigger is something that users can click on that makes the pop-up dialog box appear.
6. Select the pencil (‘Edit Trigger’) icon.
Screenshot of a Pop-up Trigger being successfully added in Confluence
7. Delete the placeholder text and type in your chosen text for the trigger button.
GIF of a user typing in the trigger text for a pop-up dialog
8. Click ‘Save’ to close the trigger editor. In the main pop-up dialog editor, again click ‘Save’.
9. You’ll now see a placeholder macro on your page.
Screenshot of the placeholder Pop-up Dialog macro
In this box, add what you'd like users to see in the pop-up. This isn’t limited to text - you can include some macros (such as Confluence buttons) too.
10. Once you’re happy with your pop-up dialog, click ‘Publish’ or ‘Update’ in the upper right of the page to publish your pop-up.

Present information the smart way

Content Formatting Macros gives you innovative ways to present information - for your team, and for your users.
Written by
A headshot of Zoriana Bogutska
Zoriana Bogutska
Senior Product Marketing Manager
Zoriana has over 12 years of experience in marketing, with 6 of them in product marketing management. As a Senior Product Marketing Manager, Zoriana aims to ensure Kolekti's apps excel by understanding customer needs, solving their problems, and making Kolekti truly the best solution.

LinkedIn →
Content Formatting