Simple Headings
On this page:
Overview
Headings allow you to create titles, separating different sections of your content.
While the Confluence editor has support for titles, they are simple text headings that change size, without any other visualizations.
The Simple Headings macro on the other hand allows for the ability to add sub-headings, visual lines, and icons to make the heading stand out from other content, and provide a visual separator.
Example Headings
Here you can see just a few examples of the different ways you can configure a heading.
How to Insert the Heading Macro
To add the Simple Heading macro to a Confluence page, use the macro insert menu "+" from editor toolbar, and select Simple Title from the macro list.
Alternatively, type ‘/' in the editor to trigger the macro insert suggestions and type ‘scm title’.
On the macro list that appears, click SCM Title to open the Headings configuration dialog.
Configuring the Heading Macro
Once the macro is inserted, it will automatically trigger the configuration dialog, allowing you to customize the heading.
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 title and subtitle, navigate to the Content tab.
The content tab gives you easy access to the things you want to edit the most: the heading text, and the subheading text.
Advanced Config Tab
If you want to further customize your heading, navigate to the Advanced Config tab, where you can change virtually everything about the heading.
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.
Primary Text Settings
The Primary Text drawer allows you to change the formatting of the main text of the heading.
Setting | Description |
|---|---|
Title Text | Allows changing the actual heading text. |
Text Color | Allows changing the color of the text. Click on the color swatch to open the color selector and set the color you want for the text. |
Text Size | Allows changing the size of the heading text using the size controls. |
Alignment | Allows you to change whether text is left, center, or right aligned. |
Text Styling | Allows you to add some styling or decorations to the text. |
Secondary Text Settings
The Secondary Text drawer allows you to change the formatting of the second line of text (subheading).
The settings here are the same as the Primary Text Settings above.
Note that the secondary text is optional, and can be enabled/disabled by using the toggle switch.
Line Visuals Settings
The Visual Line drawer allows you to change the visual settings of the heading.
Setting | Description |
|---|---|
Line Orientation | Allows you to change the orientation of the line from horizontal to vertical. |
Line Placement | Changes the placement of the line. Whether it is centered on the main heading text, or subheading, or whether it is placed above or below any text. |
Line Width | Changes the thickness of the divider line using the size controls. |
Line Type | Changes the styling of the line between from a single to a double line. |
Line Color | Allows you to change the color of the line. Click on the color swatch and select the desired outline color. |
Thickness | Changes the thickness of the line using the size controls. |
Line Style | Change the styling of the line(s) between solid, dotted, or dashed. |
How to Edit or Resize the Heading Macro
To edit a heading macro in a page, hover over the macro, and then click on the macro handle to reveal the macro configuration toolbar. Finally, on the edit icon on the toolbar that appears.
This will launch the Configuration dialog, with the Advanced Config tab active.
question:
Can I resize a heading?
The heading is a "block" macro, similar to the Confluence Divider, or Panel macro.
The height of the macro is determined by the content (and font sizes), but you can change the width of the heading from "center", "wide", and "full width", like other standard Confluence macros.