Documentation for Confluence 5.8 (Server).
Documentation for Confluence Cloud and earlier versions of Confluence is available too.

Skip to end of metadata
Go to start of metadata

In Confluence, you can replace the default space logo with an image of your choice. If you have team spaces, you can use an icon that represents the team, or if it's a space for a client, add their company logo to really impress them.

The instructions below apply to site spaces. For your personal space, your profile picture is used as the space icon.

You need to be a space administrator to replace a space's logo.

To change a space's logo, in spaces using the default theme:

  1. Go to the space and choose Space tools > Configure sidebar from the bottom of the sidebar
  2. Choose the edit icon  next to the space name
  3. Choose Upload an image
  4. Select an image from your computer
  5. Adjust the size of the image to fit within the highlighted circle
  6. Choose Save

To change a space's logo, in spaces using the Documentation theme:

  1. Choose Browse > Space Admin from the header

    Note: The Space Admin option appears only if you have space admin permissions, or if you're part of the 'confluence-administrators' group.

  2. Choose Change Space Logo in the left-hand panel
  3. Click Choose File
  4. Select an image from your computer
  5. Choose Upload Logo


  • Minimum dimensions: Space logos are set at 48 x 48px. Logos less than these dimensions will be centred with whitespace around them.
  • Space logos in the default theme are circular.
  • Dimensions of image when using the Documentation theme: The documentation theme does not provide an option to resize or crop your image. Uploading a square image will give the best results. 


  1. This option does not appear to be available for Personal Spaces, which probably makes sense but would be useful to have noted here as well.

  2. Our company's logo is a triangle. If I size the logo to the maximum allowed height, I get this gorpy-looking triangle with the bottom cropped by the circular frame. If I use my math to size the logo so that it will fit completely inside the circle, it's not bottom-justified with the text of the page title – also gorpy.

    Any suggestions for how to change the space logo frame to a more triangle-friendly shape?

  3. Anonymous

    I'm not happy with the new logo dimension constraints. We did not have this issue in the previous release of Confluence 4.3.7

  4. Hallo all

    There's a good discussion with the product managers about the new logo format happening on this page:



  5. Anonymous

    When you customize the site logo, can you define its link destination? By default, it links to the Confluence dashboard but I would like it to link to our company's web site.

  6. Anonymous

    Is it possible to point the logo to a URL instead of having to upload a file?  We have logo assets centrally managed on another server.

  7. 5.1.3 Confluence standalone on Solaris. I have custom site Logo and have it set to show both logo and title. I update, install or uninstall add-ons and it switches to Show Logo only. I then have to go back in to Look & Feel/Site logo and re-select show Logo & title and save. I have repeated this on 2 seperate installs with 2 different plugins. I'll try windows version later.

    I just verifiied that 5.1.3 standalone for windows behaves the same way. Updating an add-on changes it to Show Logo only.

    I have reported this as a bug. (CONF-29734)

  8. Anonymous

    It would be good if you could add a link to this. Is this functionality available for space icons?

  9. I've noticed that after I add a SPACE LOGO, that actual image will show up in search results (LiveSearch) and the Recently Updated macros. Is this a bug or is there a way to fix this?

    1. Not an answer, but +1 for the Doctor Manhattan forehead tatt avatar.

  10. My Company logo is Square. When i open it in Chrome it appears circular. In IE it appears square. How can change the way it appears in Chrome?

  11. To me it's confusing why the space logo is a property of the sidebar, not of the space itself. I would have expected this setting to be in "edit space details".

    1. Thanks Martin, I'll pass your comments on to the team. 

    2. Agreed. This is rather confusing.

  12. The circular logo space is definitely a limitation which is annoying your customers including my internal project teams.  Please, please do something about it.  At the very least, increase the logo space so that the cropping does not occur.  It makes more sense for the the logo space to be square rather than circular.

    1. Hi Nick, please refer to this ticket for more information on the decision to change the space logos  CONF-28275 - Provide a way to avoid the automatic rounding of space logos Resolved

  13. did anyone at Atlassian Product Management read and understand that your customers do NOT want round logos?

    Is it so hard to accept that this was a bad design decision?  Can Atlassian ever revert from their errors? Can Atlassian ever listen to their customers?

    How much more riot is needed?