Configure the Sidebar

On this page

Still need help?

The Atlassian Community is here for you.

Ask the community

If you have administration permissions for a space, you can customize the space's sidebar to have its own logo, change the way the hierarchy is displayed, and add shortcut links to help navigate to important content quickly.

To start configuring the sidebar, choose Space tools > Configure sidebar.

To change the space name:

  1. Choose  next to the space name.
  2. Type in a new space name and Save.
  1. Logo - change the space name and logo
  2. Reorder - drag to reorder shortcuts
  3. Hide - hide or show pages, blogs, shortcuts or navigation display options. 

To change the space logo:

  1. Choose the  next to the space name.
  2. Choose Upload an image.
  3. Select an image from your computer.
  4. Adjust the size of the image to fit within the highlighted circle. 
  5. Choose Save.

Things you should know:

  • Space logos are 48px x 48px. Logos smaller than these dimensions will be centred with whitespace around them.
  • You can only change the space logo for a site space. For your personal space, your profile picture is used as the space icon. 
  • Choose the icons to show or hide pagesblogsshortcuts or navigation options.
    For example, if you want your space to be used primarily as a blog you can hide the 'Pages' link.
  • Add­-ons such as Team Calendars for Confluence Server may add other links in this section of the sidebar and you can also show or hide these.
  • Choose Add link to add a shortcut link to the sidebar. This could be a link to an important page for your team, or to an external site.
  • Drag links to reorder them within each section (you can't move a link from one section to another).

Change the navigation display options

  • Choose Child pages to see the current page and its children in the sidebar.
  • Choose Page tree to see the page tree for the entire space, expanded to the current page. 
  • You can also choose to completely hide the navigation display options and instead add the pages you want to be visible as shortcut links. Alternatively, you can remove the sidebar navigation altogether and use a Page Tree Macro or Children Display Macro  on your homepage for navigation instead.

Adding custom content to a sidebar

You can further customize a sidebar using wiki markup to add custom content. 

To add custom content to your sidebar:

  1. Go to the space and choose Space tools > Look and Feel from the bottom of the sidebar.
  2. Choose  Sidebar, Header and Footer
  3. Enter your custom content in the Sidebar field. 

The sidebar, header and footer fields all use wiki markup, check our guide to wiki markup for help, or check out some common customizations below. 

Add a search field to your sidebar...

To add a search field to the sidebar add the following wiki markup for a search macro in the Sidebar field.

For the Livesearch Macro macro:


For the  Page Tree Search Macro macro:

Add a panel with some content...

To add a panel with some custom content to the sidebar add the following wiki markup for the Panel Macro in the Sidebar field:

{panel}This is some custom content to appear in the sidebar{panel}
Add your own page tree to replace the default page tree...

To hide the default page tree and add your own, with additional parameters:

  1. Add the wiki markup for the Page Tree Macro in the Sidebar field.
    The following example includes parameters to expand the top three levels of the page tree by default and include an Expand All and Collapse All link above the tree.

    {pagetree:root=Page Name|startDepth=3|expandCollapseAll=true}
  2. Go to Space Tools > Configure sidebar.
  3. Use the Show and Hide icons to hide the default page tree from the sidebar.
Last modified on Jul 29, 2022

Was this helpful?

Provide feedback about this article
Powered by Confluence and Scroll Viewport.