Simple Dividers
On this page:
Overview
Dividers allow you to give Confluence pages more structure, and help separate content on the page, to make the page layout clearer, and content more readable for users.
Although Confluence already comes with a divider, it is a simple horizontal line that lacks any customizations.
The Simple Divider Macro on the other hand can be oriented either horizontally or vertically, and customized with a variety of different colors, line styles, and icons.
Example Dividers
Here you can see just a few examples of the different ways you can configure a divider.
How to Insert the Divider Macro
To add the Simple Divider macro to a Confluence page, use the macro insert menu "+" from editor toolbar, and select the Simple Divider.
Alternatively, type '/' in the editor to trigger the macro insert suggestions and type 'scm divider'.
Configuring the Divider Macro
Once the macro is inserted, it will automatically trigger the configuration dialog, allowing you to customize the image.
Template Tab
The first screen you'll see in the Configuring dialog is the Template screen, where you'll find a collection of pre-made templates. These should give you a quick starting point for various different visuals. Selecting one of the templates will apply the settings for that template, with the results visible in the preview area in the middle.
Content Tab
To customize the content of the divider, like divider text, the line color, or the icon, navigate to the Content tab.
The content tab gives you easy access to the things you want to edit the most. You can enter a new divider text, change the color of the text using the color swatch, as well as pick an icon and different line color.
note:
Not All Icons Support Colors
The icon picker has a wide array of icons to choose from, but only the "Atlassian icons" in the last tab of the icon picker support picking a color. The remaining icons are exactly as they are, and selecting a color won't change them.
Advanced Config Tab
If you want to further customize your divider, navigate to the Advanced Config tab, where you can change virtually everything about the divider.
The advanced config is split into multiple groups, each of which has its own settings drawer. Click one of the fields to open a drawer and change the relevant settings.
Divider Visuals Settings
The visuals drawer allows you to change the visual settings of the divider line.
Setting | Description |
|---|---|
Divider Orientation | Allows you to change the orientation of the divider from a horizontal line to a vertical line. |
Line Type | Select the visuals of the divider line from the available presets. |
Line Color | Allows you to change the color of the divider line using the color swatch. |
Thickness | Change the thickness of the divider line using the size controls. |
Divider Text Settings
The Divider Text drawer allows you to change the text shown as part of the divider.
The divider text is optional. You can enable/disable the text using the toggle switch.
Setting | Description |
|---|---|
Divider Text | Allows setting the actual text in the divider. note: Dividers do not support line breaks. You can only enter a single line of text. |
Color | Allows changing the color of the text using the color swatch. |
Font Size | Change the size of the divider text using the size controls. |
Divider Icon Settings
The Divider Icon drawer allows you to change the icon used for the divider.
You can enable/disable the icon using the toggle switch.
Setting | Description |
|---|---|
Icon Type | Select which icon you want to use. You can navigate between different icon sets, or use the search function to find icons. |
Color | Pick the color you want for your icon. Use the color swatch to change the color of the icon. note: The remaining icons are exactly as they are, and selecting a color won't change them. |
Icon Size | Change the size of the icon to suit your needs using the size controls. |
Icon Background | Change whether the icon should have a background or not. The background can be shaped like a square, or a bubble around the icon, and will use the same color as the divider line itself. |
Icon Background Color | Use the color swatch to change the background color of the icon within the divider. |
How to Edit or Resize the Divider Macro
To edit a divider on a page, hover over the divider macro, and then click on the macro handle to reveal the macro configuration toolbar. Finally, click on the edit icon.
This will launch the Configuration dialog where you can modify different settings for the selected divider macro.
question:
Can I resize a divider?
The divider is a "block" macro, similar to the Confluence Divider, or Panel macro.
You can change the width of the divider between "center", "wide", and "full width".
How to Add Text Content for Vertical Dividers
While it's not possible to directly add text content in the vertical dividers macro, you can simply use the layout macro with 3 column configuration to achieve this.
Start with adding a new column macro and set it to three columns.
Next, move the text cursor to the middle of the 3-column layout and insert the vertical divider macro in there (see below).
You can configure the divider macro to your preferences before finally inserting it into the page. Proceed to enter text content into the left and right columns of the layout macro.
Compatibility with Other Macros
The Simple Divider macro is compatible with most built-in Confluence macros that allow you to place other content inside of it.
This means, you can put a divider into a Columns/Layout macro, or a standard Panel, a table, and so forth.