Background

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

  1. Navigate to the page you want to edit.
  2. Click the Edit icon.
  3. Click InsertView More.
  4. Select the Background macro in the Browse screen.
  5. Customize your background using the following options. Changes you make will be shown in the dynamic preview of the editor.

    ParameterDescriptionNotes
    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


    Image

    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

    Image Size

    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

    Horizontal

    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.

    Rounded Corners

    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.

  6. Click Insert. A macro placeholder is displayed.
  7. Insert the content you want inside the macro.
  8. 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.

  1. Click the background macro, then click the Edit icon.
  2. 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.

  1. To keep the content, first copy it and paste it outside the macro.
  2. 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.

MacroWorks As NormalNotes
Alert Macro

The alert will display each time that the macro holding it is opened.
Button Macro


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.

Card Macro


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.
LaTeX Macro


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.
Tooltip Macro


MacroWorks As NormalNotes
Action Item


Attachments

This macro displays the attachements on the page. However the drag and drop upload function does not work. 
Blog Posts


Bullet List


Code Snippet


Contributors


Contributors Summary


Chart

This type of macro will not fit inside another macro.
Change History


Children Display


Content by Label


Content Report Table


Create From Template


Date


Decision


Decision Report


Emojis


Error Panel


Excerpt

This type of macro will not fit inside another macro.
Excerpt Include



Expand

If you wish to use this macro you can put it in the cell of a table, inside the macro.
Files and Images


Gallery


Iframes


Include Page


Info Panel


Jira Charts


Jira Issue


Jira Roadmap

Only displays a link.
Layouts

This type of macro will not fit inside another macro.
Labels List


Link


Mention


Note Panel


Numbered List


Opsgenie Incident Timeline


Page Index


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


Page Tree Search


Popular Labels


Profile Picture


Related Labels


Recently Updated 


Recently Updated Dashboard


Roadmap Planner

The roadmap displays, but the links do not display when you hover over the bars. 
Shared Links Bookmark


Spaces List


Status


Success Panel


Table 


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. 
Team Calendars


Trello Card


Trello Board

Although the board will display in edit mode, it does not display in view mode. 
User Profile


Warning Panel


Widget Connector


Video Walkthrough

On this page