Background is a macro that allows you to easily add a background of your choice to your page. You can add multiple Background macros to your page as a way to segment the information you are presenting. It's a great tool to engage your audience by combining images and color to attract attention to key information, enhance your brand identity, and break up content into easily digestible chunks.
Add a Bacground Macro to your page
- Navigate to the page you want to edit.
- Click the Edit icon.
- Click Insert > View More.
- Select the Background macro in the Browse screen.
Customize your background using the following options. Changes you make will be shown in the dynamic preview of the editor.
Parameter Description Notes Color Palettes
Changing the color palette will change the presented options for Background Color and Text Color.
The options are:-
Default - The options are a standard selection of colors that do not change. There are different options for the background and text colors.
Recently used - The options offered will be the last seven colors you have used in any of our macros.
Local Space - The options offered in this palette are specific to the space. The Space Admin can create and edit this palette. This may be used for your team's colors of choice.
Organization - The options offered in this palette are the same in every space. Confluence Admins can create and edit this palette. This may be used for your organization's brand colors.
If you have not yet saved a macro, there will be no color options in the recently used palette. Background Color
Choose the background color for the text box. If you don't select any, the background will default to white.
You can choose one of the preselected colors, or select the Pencil to open a color picker and choose any color you want.
The appearance of the color picker will depend on which browser you are using. Background Color Opacity
Choose how opaque the background is by moving the slider or typing in a value from 0 to 100
The lower the value, the more see-through the background
If you enter a number larger than 100, it will set the slider to full. Text Color
Choose the text color for the content of the background macro. If you don't select any, the text will default to black.
You can choose one of the preselected colors, or select the Pencil, to open a color picker and choose any color you want.
The appearance of the color picker will depend on which browser you are using. Text Alignment
Choose the alignment of the text inside the macro
The options are: Left, Center, Right
Selecting this button will give you two options; Upload or Stock image. Once you have selected your image, use the left arrow to return to the main editor.
a) Upload. This option allows you to add your own image. You can drag and drop an image file into the macro window or click Upload image to select an image file from your local file storage.
b) Stock image. This option allows you to search for an image from our free image library. Simply select the image you want to see how it will look on your card.
Accepted image formats: JPEG, PNG, GIF, ICO BMP, and WEBP
Maximum file size: 15 MB
There are three options for image size in the dropdown menu:
Original Size - the original size of the upload will be maintained
Resize to fit into the container - the image will be sized so you can see the full image within the background; there may be some space around the image.
Resize to fill the container - the image will be sized, so the entire background is filled with the image. You may not be able to see the whole image.
You can see examples of how the different sizes look below. Background Image Opacity
Choose how opaque the image is by moving the slider or typing in a value from 0 to 100.
The lower the value, the more see-through the background image.
If you enter a number larger than 100, it will set the slider to full. Image Repeat
Choose No Repeat or Repeat. Repeat will tile the images across the background.
If you select Repeat, a dropdown appears for the Image Repeat Direction. You can choose from:
Horizontal and vertical
You can see examples of how the different effects look below. Image Position
Select the image position from a dropdown menu.
The options are Top left, Top center, Top right, Center left, center, Center right, Bottom left, Bottom center, and Bottom right.
You can see examples of how the different positions look below. Width
With the selector, you can control the width of the background macro.
Full Width - The background will take up the full width available.
Custom - Selecting this makes a slider appear. Whit that you choose what percentage of the width of the available space the background takes up.
A dropdown menu will also allow you to select the alignment of the background on the page. The options are Left, Centre, and Right.
If you enter a number larger than 100, it will set the slider to full. Height
With the selector, you can control the height of the background macro.
Auto - The background will change the size to fit the content.
Custom - Selecting this makes a slider appear. You can choose how many pixels high the background will be. The range is 100 - 1000 pixels.If you enter a number larger than 100, it will set the slider to full.
If you set a custom height. This is the minimum height the background will have. It will always expand to show your content.
Choose the radius of the curve for the corners by moving the slider or typing in a value from 0 to 40.
The higher the value, the more obvious the rounded corner will be.
The default value is 3px.
If you enter a number larger than 40, it will set the slider to full.
- Click Insert. A macro placeholder is displayed.
- Insert the content you want inside the macro.
- Click Publish to see the Background macro in action.
Use an Image
To use an image as your background, drag and drop your chosen image into the editor or select Upload. Then use the parameters to modify the image to suit your needs.
Images that are inserted inside the macro are part of the foreground. They will not be affected by the image parameters of the macro. For an image to be part of the background, you must upload it through the macro editor.
Edit the Background
To make changes to a Background macro after it is published, first display the page in Edit mode.
- Click the background macro, then click the Edit icon.
- Make your desired changes, then click Save.
Remove a Background Macro
To remove a Background after it is published, first display the page in Edit mode.
- To keep the content, first copy it and paste it outside the macro.
- Click the background, then click the Trash icon.
Put Other Macros Inside
It is possible to put other macros inside this one. Some larger or more complex macros may not work, or work differently than expected.
When trying to figure out which marcos can be put inside others there it helps to identify the type of macro you are working with. There are two general types of macro:-
Rich Body Macros -There are macros that you can type in on the Confluence Edit page
Simple Macros - These are macros that you can not add anything to on the edit page, you can only affect them by opening them in the editor.
Typically Rich Body Macros, do not work as expected, or at all when put inside other Rich Body Macros.
Most, but not all Simple macros can be put inside a Rich Body Macro, and often work as expected.
See below for more information on what happens when you put various macros inside this macro.
|Macro||Works As Normal||Notes|
|Alert Macro||The alert will display each time that the macro holding it is opened.|
|Button Group||This type of macro will not fit inside another macro.|
|BibTeX Reference Macro||References within tabs will only display in a Summary Macro in the same tab.|
|BibTeX Summary Macro||The Summary Macro will only list BibTeX references within the same tab.|
|Footnote Macro||Footnotes within tabs will only display in a Summary Macro in the same tab.|
|Footnote Summary Macro||The Summary Macro will only list Footnote references within the same tab.|
|Progress Bar Macro||Works as long as there is only one progress bar on a page. If there are multiple nested progress bars on a single page it can cause a failure.|
|Round Rectangle Macro||This type of macro will not fit inside another macro.|
|Tabs Macro||This type of macro will not fit inside another macro.|
|Macro||Works As Normal||Notes|
|Attachments||This macro displays the attachements on the page. However the drag and drop upload function does not work.|
|Chart||This type of macro will not fit inside another macro.|
|Content by Label|
|Content Report Table|
|Create From Template|
|Excerpt||This type of macro will not fit inside another macro.|
|Expand||If you wish to use this macro you can put it in the cell of a table, inside the macro.|
|Files and Images|
|Jira Roadmap||Only displays a link.|
|Layouts||This type of macro will not fit inside another macro.|
|Opsgenie Incident Timeline|
|Page Properties||This type of macro will not fit inside another macro.|
|Page Properties Report||This macro works as normal except when the table contains any other macros.|
|Page Tree Search|
|Recently Updated Dashboard|
|Roadmap Planner||The roadmap displays, but the links do not display when you hover over the bars.|
|Shared Links Bookmark|
|Table of Contents|
|Table of Content Zone||This type of macro will not fit inside another macro.|
|Task Report||If you have enough tasks to result in multiple pages of tasks, you may not be able to scroll through the pages.|
|Trello Board||Although the board will display in edit mode, it does not display in view mode.|