The Adaptavist Group LogoDocumentation

Pop-up Dialog

The Pop-up Dialog macro is an excellent tool for adding extra information to your page. You can add a trigger to your page, which activates a popup box with your content. You can embed other macros, like the button macro inside the Pop-Up Dialog. This can be a valuable way to direct users to the most relevant content.

Add a Pop-up Dialog macro to your page

  1. Navigate to the page you want to edit.
  2. Click the Edit icon.
  3. Click Insert → View More.
  4. Select the Pop-up Dialog macro in the Browse screen.
  5. Complete the Pop-up Dialog Title field. eg. More Information Here.
  6. Select a width for the dialog box from the Pop-up Dialog Width drop-down menu.
  7. Select the Add Pop-up Trigger button.
  8. To edit the appearance of the trigger, select the edit icon.
  9. Complete the Trigger Text Field with what you want the button to say. eg. Click for More Information.
  10. Choose the alignment of the trigger button.
  11. Select Save.
  12. In the main macro editor, select Save.
  13. A macro placeholder appears on your page. Insert the content you want to show in your Pop-up Dialog inside this macro.
  14. Publish the page
  15. The trigger button now appears in place of the macro placeholder.

Example

In this example, the dialog macro has two Button macros inside it. One has a link to an external webpage, and the other points to an anchor on the same page. You can use Pop-Up Dialogs in this manner to create simple decision trees.

Video Walkthrough

Watch our video walkthrough to see the Pop-up Dialog macro in action.

Create Decision Trees

If you have a lot of content on a page, it can be challenging for viewers to find the relevant information for their needs. Decision trees can help you direct your page viewers to the most relevant information to meet their needs quickly and easily. You can use the dialog macro to direct users to specific content on the same page or different pages by combining it with anchors and the Button macro.

Instructions

  1. Set up your page with your content.
  2. If you want to link to a specific place on any confluence page, you will need to add an anchor macro.
  3. Give the anchor macro a clear and unique name. eg Personal
  4. Insert a Pop-up Dialog.
  5. Inside your Pop-Up Dialog macro, insert a Button macro.
  6. To link to an anchor, type #[your Anchor Name] in the field and click on Add URL. eg #Personal. To link to a different confluence page type the name of the page and select it from the search box.
    Note: The anchor name is case-sensitive.
  7. Select Save.
  8. Repeat for as many options as you want to give inside your Pop-up Dialog.
  9. Publish your page.
  10. Test that your buttons inside your Pop-up Dialogs go where you expect.

Example

In this example, a long page with many options is made easier to navigate with the use of Pop-Up Dialogs, which direct the user to the next set of questions they need to answer, ultimately leading them to the product that best fits their needs.

Search documentation

Start typing to search the docs.