Customizing the Confluence Dashboard

The dashboard is the default landing page for your Confluence site. It gives people all the tools they need to discover pages, resume their work and quickly jump to their favorite spaces and pages. 

Editing the site welcome message

The site welcome message appears on the right hand side of the dashboard and is the perfect place to inject some of your organization's personality. 

See Editing the Site Welcome Message to find out how to add announcements, useful links, images, macros and more. 

You'll need Confluence administrator permissions to edit the site welcome message. 

Using a page as the site landing page

If you want more control, you can choose to use an ordinary Confluence page as your site landing page, instead of sending people to the dashboard.  See Configuring the Site Home Page to find out more. 

Using a page instead of the dashboard can be useful if most people will be reading, rather than creating, pages in your site. However, for sites where you want to encourage teams to collaborate, the dashboard provides the best tools for resuming work in progress and keeping up with what is happening in the site. 

Advanced customizations

You can further customize the dashboard by editing the global layout file.  See Customizing Site and Space Layouts for more information on how to do this.  You'll need some knowledge of Velocity to modify the layout files.

There are two locations that you can add content to:

  • Web panels added to atl.dashboard.secondary will appear below the site welcome message.
  • Web items added to system.dashboard.button will appear next to the Create space and Invite users button at the top right of the dashboard. 

If you modify layouts in Confluence you will need to reapply your modifications each time you upgrade Confluence. The more dramatic your customizations are, the harder it may be to reapply the changes when upgrading.  See Upgrading Customized Site and Space Layouts to find out what will be involved before modifying the layouts. 

Last modified on Oct 6, 2021

Was this helpful?

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