Editing the Site Welcome Message

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.

Was this helpful?

Thanks for your feedback!

16 Archived comments

  1. User avatar


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

    16 Feb 2011
    1. User avatar


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

      Administration -> Look and Feel -> Layouts

      07 Mar 2011
  2. User avatar


    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!

    01 Apr 2011
  3. User avatar

    Pieter van Kampen

    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?

    17 Oct 2011
  4. User avatar


    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.

    06 Mar 2012
  5. User avatar


    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?

    15 May 2012
  6. User avatar


    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?


    22 May 2012
    1. User avatar


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

      11 Jul 2012
  7. User avatar


    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?

    23 Oct 2012
  8. User avatar


    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.

    13 Dec 2012
  9. User avatar

    John Ragland

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

    24 Jan 2013
    1. User avatar


      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)

      21 Mar 2013
  10. User avatar

    Beth Aitman

    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?

    15 Aug 2013
  11. User avatar


    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?

    01 Oct 2014
    1. User avatar

      Giles Brunning [Atlassian Technical Writer]

      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?

      02 Oct 2014
      1. User avatar


        Hi Giles, 

        I just submitted it, thanks!

        02 Oct 2014
Powered by Confluence and Scroll Viewport