Access Keys:
Skip to content (Access Key - 0)

Adaptavist Documentation Move

This documentation is deprecated. Adaptavist's documentation has moved to a new location where it is maintained and updated. Please visit Adaptavist's new Documentation area.

Custom Dashboards

If you're looking for the Confluence Dashboards Plugin, please go to the Confluence Dashboards Plugin page here

NB: This method of replacing the dashboard has been superceeded by the Dashboard Tab in Builder 3.x

This tutorial shows you how to create completely customised dashboards...


We have been getting lots of requests asking how we made our heavily customised Dashboard= on this website. This tutorial covers the basic concept of creating a custom dashboard and we'll add more tutorials showing how to furter customise it over time.

To create a custom dashboard, we will redirect requests from The Dashboard to a specific Space, thus allowing full customisation of the new "dashboard space" that's presented to users.


You will need to be logged in as a System Administrator and must have the following plugins installed:

In addition, we strongly recommend installing the following plugins as they will give you far more control over personalisation and customisation of your custom dashboard:

Other plugins that might be of interest, depending on what features you want on your dashboard, include:

  • Page Tree Plugin - an interactive site map can be added with the pagetree macro
  • Linking Plugin - links to common locations, such as the user profile, can be added using the link-to macro

Step 1 - Create a Custom Dashboard Space

Create a new space to hold your new dashboard. You can call it anything you want, but we recommend using "Dashboard" as the space key so that URLs will be like:

Step 2 - Build the new Dashboard

The home page of the space you have just created will be your new dashboard. Edit the page to include the following:

Insert your introduction text here

You'll now have something that looks similar to the default dashboard:

Insert your introduction text here

Atlassian Confluence Wiki
Atlassian's Confluence Enterprise wiki documentation
Atlassian Support Services - JIRA support, JIRA Enterprise Support, Confluence support and other Atlassian services
Adaptavist provide a wide range of support services from free Community support to missioncritical 24/7 Enterprise servi...
Atlassian Training Services - JIRA training, Confluence training and other Atlassian training services and courses
Adaptavist provide online and onsite training for Atlassian products and plugins.
Community Bubbles Plugin
Tutorials, forum, support and more for our Community Bubbles plugin which adds social networking, communities, forums an...
Confluence, JIRA, JIRA Enterprise and other Atlassian Product Consulting and Best Practice
Our bespoke solutions can be tailored to your exact needs. Services include plugin development, Confluence Health Check,...
Confluence Plugins and Macros for your Atlassian Wiki
Information and documentation about Adaptavist's range of Confluence Plugins and Plugin Packs.
Confluence Plugins Community - Add questions, answers, ideas, bugs and improvements related to our plugins and Atlassian software
Find out what Adaptavist are doing to protect the environment.
An example of a Flickr like wiki theme developed with Theme Builder
Free Plugins
Adaptavist regularly release projects as open source, licensed as BSD, ASL2 or MIT. We don't believe in, and will never ...
JIRA hosting, Confluence hosting and other Atlassian hosting services - dedicated and shared solutions
Starter, dedicated and remote hosting services for Confluence, JIRA and all other Atlassian products.
Public Resources
This space contains several resources (eg. images, logos) that are used throughout our site. It's easier to keep them in...
Theme Builder Plugin
Tutorials, forum, support and more for our Theme Builder plugin, which is used to customise Confluence.
An example of a Wikipedialike wiki theme developed using Theme Builder.

Recently Updated

Favourite Pages
Displaying pages recently added to your favourites list.
my-favourite-spaces macro (Community Bubbles Plugin)
my-favourite-pages macro (Community Bubbles Plugin)
my-favourite-users macro (Community Bubbles Plugin)

Obviously, you'll probably want to change this design – we've only used it in this example so that you can see the key macros that have been used on the original dashboard:

  • spaces macro - displays a tabbed list of spaces
  • recently-updated macro - displays a list of recently updated content
  • favpages macro - displays the favourite pages for the logged in user

Step 3 - Redirecting to the new Dashboard

Now, it's no use having a new dashboard if everyone keeps going to the old dashboard. To get round this problem, we use the redirect macro.

Go in to General Configuration and in the Site Welcome Message setting, add in the following:


This will redirect all requests to your original dashboard to the new dashboard.

Related Tutorials

We're bound to get plenty of questions on this tutorial and will be creating more tutorials showing additional tricks here...

If you have a question on customised dashboards, please ${renderedContent}.

Frequently Asked Questions

Q Why doesn't the recently-updated macro reflect the spaces shown by the spaces macro?
A Sadly, this only works on the original dashboard. At present, it's not possible to filter the list of recently updated content to the spaces shown in the selected tab of the spaces macro.

View old comments

Adaptavist Theme Builder Powered by Atlassian Confluence