Aura Background Content (Cloud)

The Aura Background Content macro allows you to add a background image, a background color, or both in combination. You can then insert content or macros into the background content macro. Further down in the 'Compatibility' section you can see which content and macros you can insert into the Aura Background Content macro.






Please follow these steps to insert an Aura Background Content macro on a Confluence Page:

  • Go to the Confluence page you wish to edit

  • Click on the Edit button of the Confluence page or press "E"

  • In the page editor click on the + button (Insert More Content) and select Other macros

  • Select the Aura Background Content macro from the provided list and the configuration dialog appears




Please follow these steps to edit an Aura Background Content macro on a Confluence page:

  • The configuration dialog helps users to create the background that suits their needs. The live preview shows the result in realtime.

  • After the configuration is done click Save and the Aura Background Content will be visible on your Confluence page. Clicking on Close will abort the configuration and the inserting of the macro.

Content Vertical Position

Choose how you would like to position your content:

  • Top

  • Center

  • Bottom

Mininum Height

Choose a suitable minimum size for your background content container. The content container is dynamic and adjusts automatically with your content.


Choose suitable padding for your content.


Click on the Add Background Color button to use the background color. You will then be presented with more options:

  • Choose from predesigned color palettes (provided by administrators) that suit your needs.

  • Each color palette comes with a set of up to 18 different colors that will, for example, match the company's brand and corporate identity.

  • Click on a color box to apply the color to the button.

  • An applied color box is highlighted with a white frame and a white circle.

  • The paint bucket allows you to pick a custom color as well as adjust the transparency of the color.

  • You can remove the color by clicking on the Remove Background Color button.


Click on the Add Image button to open up the 'Image Sidebar'. Choose from one of three options presented as tabs:

  • Aura Images, Attachments or Direct Link


Aura Images

All images are provided by and can be used freely. Find out more about the licence here.

Add image

  • To add an image to your Background Content simply click on an image.

Search & filter

  • Search field: Enter the desired term

  • Orientation: Choose Landscape, Portrait or Square

  • Color: Choose whether your image should be ‘Black and white’ or a specific color



Either use an image that has already been attached to a Confluence page or upload a new image onto the current page.

Use already attached image

  • Search field: Enter the name of the image

  • Filter dropdown: Specify where the image should be searched

  • Table: All images matching the search are displayed in the table. Hover on image titles for a preview. Click on an image title to select it.

Upload and use new image

  • Users can either upload a new image via drag and drop or by clicking into the 'Upload attachment' box.

  • The uploaded image is automatically set in the Background Content macro.



Direct Link

Enter a link to an image.




Please follow these steps to edit or remove the Aura macro on a Confluence Page:

  • Go to the Confluence page you wish to edit

  • Click on the Edit button of the Confluence page or E

  • Click on the Aura macro you wish to edit or remove

  • A small dialog with the options Edit and Remove appears

  • Click on the desired action



This table shows which content/macros can be inserted and used inside this Aura macro. Please note that the compatibility may change with each new cloud version that Atlassian releases.







Text & Formatting (color, italic etc.)

Empty lines are ignored (by Atlassian and we can not change that)



Bullet List


Numbered List


Check List

Editing in page view mode is unsupported


Cell color and sorting is unsupported.


Links are displayed in full length


Images can be scaled, but the size differs between Edit and View mode.




Most of the emojis are displayed as a blue star. This is a bug that Atlassian has to fix.

Here is an incomplete list of working emojis:

Code snippet

Content is visible, but line numbering, color highlighting and copy button are not available.





Atlassian Panels

The design differs in view mode compared to edit mode


The design differs in view mode compared to edit mode







PDF (directly inserted)





Activity Stream


Advanced Roadmaps for Jira

not tested


Agile Wallboard Gadget

not tested


Assigned to Me



Versions can not be maximized. Upload drop zone is not working. Uploading through button does not work.

Aura - Background Content


Aura - Button


Aura - Cards


Aura - Divider


Aura - Panel


Aura - Title


Average Age Chart


Average Number of Times in Status


Average Time in Status


Blog Posts

The ‘Create blog post’ button is greyed out and can not be used.

Change History




Children Display


Content by Label


Content Report Table




Contributors Summary


Create from Template


Created vs Resolved Chart


Days Remaining in Sprint Gadget

not tested


Decision report




Excerpt Include


Filter Results




Heat Map




Include Page


Issue Statistics


Issue in progress




Jira Charts


Jira Issues Calendar


Jira Road Map


Jira roadmap

not tested


Labels Gadget


Labels List



Visuals differ between Edit and View mode. Clicking on the 'Search' button displays the search results and the confluence frame at the top of the opened page.

Office Excel


Office Powerpoint


Office Word


Opsgenie Incident Timeline

not tested


Opsgenie Incident Timeline EU

not tested


Page Index


Page Properties


Page Properties Report


Page Tree


Page Tree Search

Clicking on the 'Search' button displays the search results and the confluence frame at the top of the opened page.



Pie Chart


Popular Labels


Profile Picture




Quick links


Recently Created Chart


Recently Updated

The Show More button open an ugly list of more recently updated content.

Recently Updated Dashboard

The tabs My Spaces & Network can not be opened.

Related Labels


Resolution Time


Roadmap Planner


Shared Links Bookmarklet Button


Spaces List

The tab Favourite can not be opened.

Sprint Burndown Gadget


Sprint Health Gadget


Starred filters


Table of Content Zone


Table of Contents


Task report


Time Since Chart


Time to First Response


Trello Board

Seems to work

Trello Card

Seems to work

Two Dimensional Filter Statistics


User List


User Profile


Version Report


Voted Issues


Wallboard Spacer Gadget

not tested


Watched Issues


Widget Connector (YouTube Videos etc.)


Workload Pie Chart