Showing results for 
Search instead for 
Did you mean: 
Sign up Log in

Earn badges and make progress

You're on your way to the next level! Join the Kudos program to earn points and save your progress.

Deleted user Avatar
Deleted user

Level 1: Seed

25 / 150 points

Next: Root


1 badge earned


Participate in fun challenges

Challenges come and go, but your rewards stay with you. Do more to earn more!


Gift kudos to your peers

What goes around comes around! Share the love by gifting kudos to your peers.


Rise up in the ranks

Keep earning points to reach the top of the leaderboard. It resets every quarter so you always have a chance!


Come for the products,
stay for the community

The Atlassian Community can help you and your team get more value out of Atlassian products and practices.

Atlassian Community about banner
Community Members
Community Events
Community Groups

Can you add a background to your confluence space?

I am wondering if a background image can be added to ones Confluence space?

2 answers

Hi @Elizabeth Saucedo,

Sure, you can do that by using CSS modifications.

Here's what you can do:

1. On the page where you want to change the background, add a macro that allows mofidying HTML code of a rendered page.

You can choose from:

  • HTML macro (this can be added from the control panel in Confluence; the macro can be disabled, so if you don't see it, problably your Confluence admin has disabled usage of this macro)
  • Markdown macro (this one is supposed to inject Markdown, but actually you can add anything from HTML through CSS to JavaScript. Content inside the macro will be injected on the page after you finish editing the page.

2. Attach your background image to the page.

3. In the image dialog right-click the added background image and select Copy the image URL from the context menu.

Alternatively, insert the attached image to the page, save the edits and then copy the image URL as you normally do on the web using your browser (right-click the inserted image and copy its URL location). When copied, you can delete the inserted background (but leave the attachment).

4. Insert the following code inside the added Markdown or HTML macro

#main {
   // background-color: lightblue !important;
 background-image: url("") !important;
 background-size: 100% 100%;


This is the identifier of the page canvase where Confluence displays the page text. It's the CSS selector for the main ID.

This line sets the backround-color if your image is transparent.

   // background-color: lightblue !important;

Following line adds the attached background:

background-image: url("") !important;

The !important flag at the end is the rule that overrides other background-image properties should they be applied to the page (unless they also have this rule applied to them).

Finally, this line stretches and fills the added background image across the full canvas drawn by the main element.

background-size: 100% 100%;

I believe you can also to that by JScript but I feel that using CSS will be preferrable (it's handled first, you won't need the page to draw and finish loading).

If you need to apply this image to every page in your space, you can do one of the following:

  • Add the CSS within the space settings - this will apply the CSS to every page existing in the current space.
  • Add the CSS inside the Markdown macro for a page template - this will ensure that every time your users create a new page, this CSS will be automatically added to the created page so that the page will render with a changed background. All previously added pages will remain untouched.
L A I'm New Here Jan 19, 2023

Thank you, do you have any recommendations for the pic size?

Nur für mich als Zusatzfrage dazu: Wird dadurch der Hintergrund (Bild etc.) für die gesamte Website aktiv? Oder z.B. in Confluence nur für die Seite und die Sidebar bleibt unberührt?

L A I'm New Here Jan 20, 2023



I believe it's not possible. Colors and themes, yes.


This does not work. 

Like FERRAMENTAS ITSM likes this

Suggest an answer

Log in or Sign up to answer

Atlassian Community Events