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

The site welcome message appears at the top left of the Confluence dashboard. You can change the default message by editing the appropriate system template. For example, you may want the welcome message to display an introduction to your site or a message of the day.

To edit the site welcome message:

  1. Choose the cog icon , then choose General Configuration under Confluence Administration

  2. Choose Global Templates and Blueprints in the left-hand panel.
  3. Choose Edit next to Default Welcome Message.
  4. Type your message into the template editor.
  5. Choose Save.

The default site welcome message

By default, the site welcome message looks more or less like the screenshot below, starting with the heading 'Welcome to Confluence' and ending with '...diagrams, and projects'.

To restore the default site welcome message:

  1. Choose the cog icon , then choose General Configuration under Confluence Administration

  2. Choose Global Templates and Blueprints in the left-hand panel.
  3. Choose Reset to default next to Default Welcome Message.

Screenshot: Site welcome message at top left of the dashboard

Using the template editor

Enter text into the body of the template, and use the editor toolbar to apply styles, layout and formatting. You can add links and macros. In general, you can use the Confluence editor in the same way as on a page.


  • You cannot use template variables in the welcome message template.
  • You can't attach an image or other file to a template. Instead, attach the file to another page, and insert it into the body of the template.

    For example:

    • You can attach an image to a page and then choose Insert > Files and Images to embed the image into the template.
    • You can attach a PDF to a page and then choose InsertOther MacrosPDF to embed the PDF into the template.

Including content from another page

It may be useful to write your welcome message on a normal Confluence page and include the page into the welcome message template. Using a normal page means that you can allow other people, who are not Confluence administrators, to change the welcome message.

To include content from another page:

  1. Create a Confluence page as usual and add your welcome message as the page content. Remember to limit the size of the content, because it must fit nicely onto the dashboard. For this example, let's assume the title of your page is 'Dashboard Message'. You can put it in any space you like.
  2. Add page restrictions or space permissions to the 'Dashboard Message' page or space, to suit your requirements. You may want to restrict the editing of the page to a group of people, or you may want to allow any employee to edit the page. This will determine who can update the welcome message on the dashboard.
  3. Edit the welcome message template, and add the Include Page macro to display the content from your 'Dashboard Message' page.

  4. Save the welcome message template. The dashboard will display the content of the template immediately, including the content of your 'Dashboard Message' page. Similarly, if you or anyone else edits the page, the welcome message on the dashboard will change as soon as the page is saved.


  1. Anonymous

    Our site welcome message disappeared shortly after we upgraded to 3.4. Any ideas why?

    1. Anonymous

      You've probably modified global layout. Reset it to system default.

      Administration -> Look and Feel -> Layouts

  2. r

    I added the include macro, but it says that the page is not available. Even though the page is present in

    that space. Please Help!

  3. In 3.x I had a Jira Issues macro included in the Site Welcome Message. We use the Confluence Dashboard as our home page, and this gave us a direct view on the open issues.

    I get an error message in 4.0 on the macro. Is there a way to include a macro in 4.0 in the welcome message?

  4. Anonymous

    I am wondering if anyone has noticed that you broke the external site linking in the site welcome message in 4.0 + and have yet to fix it.  Am I the only one using it?  I created a link to the Confluence User's Guide from our wiki.  It would be nice if it worked.

  5. Anonymous

    We have 4.0.2 running. In this version the external site linking works, but I can't use it with images instead we get a broken link. Maybe this is fixed in the next version?

  6. Anonymous

    Trying to put color and a bigger heading to my welcome page (eg. h1. {color:red} Welcome to my Page {color}. However it is displayed as "Welcome to my Page "> Welcome to my Page". The second Welcome to my Page is highlighted in red. This works perfectly fine in Jira but here it is another story... Would not be nice to have proper editing functionality instead of remembering all these *, #, color, etc. Can anyone help?


    1. Anonymous

      While I can't help you, I can confirm that it is happening to me also in Confluence 4.2.8.

  7. Anonymous

    I am trying to include page content on my welcome message and it keeps saying: Unable to render {include} The included page could not be found.

    Not sure what I am doing wrong - It seems I have followed documentation fully.

    Any ideas?

  8. Anonymous

    Did you give the space key before the page?  - |DS:Company Induction

    DS above is the Space key.

    Company Induction is the Page in the space.

    To find the space key - Go to the space where your page is and look in the url after '/display/', you will find it. I hope I am clear.

  9. Is there a way to present a different welcome message for logged on users than for other visitors?

    1. Anonymous

      Still an intresting question! I used to achieve this with the CustomWare Visibility Plugin, but this is not working with Confluence 5.0 yet. (sad)

  10. The instructions for "Including content from another page" aren't right, because the Include Page macro doesn't actually display properly on the Dashboard. There's a bug for this JIRA but until it's fixed, Atlassian, could you change your documentation to reflect the fact that in Confluence 5.1.5 and later you can't use the Include Page macro on the Dashboard?

  11. I'm trying to use the 'create page from template' button macro in my welcome message. When I set it up and try to test it by clicking the button, nothing happens, my dashboard just refreshes. Any ideas?

    1. Hi Alice,

      Looks like it might be a bug. Can you raise it here and let the team the precise version you're using so they can investigate?

      1. Hi Giles, 

        I just submitted it, thanks!