Add maintenance page in Confluence


I have added a maintenance page in JIRA to show users when we do not allow them to access the application. This page is located in <JIRA-INST>/atlassian-jira (next to the 404 page etc) and we control this with the apache in front of JIRA. Works like a charm!

But, when I try to dp exactly the same in my Confluence instance I get a weird effect. The maintenance page (pure html) is located in <CONF-INST>/confluence (next to the 404.vm etc) and when I access this page it shows alright but I also see my Confluence menubar (?!) on the top which makes it possible for user to open e.g. the Dashboard.

Does anyone have some ideas why this is the case? Even though I pinpoint my maintenance-page like this: https://my-server/maintenace.html (as I said it works in JIRA like: https://my-jira-server/jira/maintenance.html, yes I have a context path in my JIRA installation but not in Confluence)

Thanks in advance!

// Svante

4 answers

1 accepted

2 votes
Answer accepted

If I understand this correctly, you could disable decorators on a pattern that matches the maintenance page. For example, let's say your page is called "maint.html".

You could edit the decorators.xml file and add a new entry within the <decorator name="none"> block:


Hi Matthew,

Thanks for this brilliant tip!

It worked like a charm! I put the maintenece-page in the confluence/confluence folder and updated the decorators.xml file with the absolute path to this page!

Now the Maintenance-page is shown without the Confluence-bar!


Thanks again!

// Svante

0 votes
Peter Koczan Atlassian Team Jun 17, 2013

Hi Svante,

The recommended way of having a maintenance page is described here:

Also, we have a feature request to provide this function natively in Confluence:

I hope you find the above helpful to get this working for Confluence. As of the specific problem, Confluence headers will be added for all pages served for Confluence, can you let me know the version you are using? Maybe that's the catch here.

Kind regards,


Hi Peter, thanks for your really quick answer!

I have looked at the link you provided and I rather want to manage this with my reversed proxy to avoid having to shutdown Confluence as well as update the server.xml file.

We are currently running Confluence 4.3.7

Do you mean that all pages shown from the confluence instance automatically gets the main menu bar added? (with the Dashboard-link, search box etc)


// Svante

0 votes
Peter Koczan Atlassian Team Jun 17, 2013

Yes, this is the case, I have just tested it on the very latest EAP version of Confluence 5.2, even there it will act like this. You can try and playing around with CSS to hide the unwanted elements based on the tutorial here: []

However, for this you'll need to apply the css from within the custom html page you put in the root of Confluence.

Kind regards,


BTW, you can achieve similar behavior by appending ?decorator=none to the URL. Fun tip for testing. :)

Suggest an answer

Log in or Sign up to answer
Community showcase
Published Mar 12, 2019 in Confluence

Confluence Admin Certification now $150 for Community Members

More and more people are building their careers with Atlassian, and we want you to be at the front of this wave! Important Dates Start the Certification Prep Course by 2 April 2019 Take your e...

271 views 2 10
Read article

Atlassian User Groups

Connect with like-minded Atlassian users at free events near you!

Find a group

Connect with like-minded Atlassian users at free events near you!

Find my local user group

Unfortunately there are no AUG chapters near you at the moment.

Start an AUG

You're one step closer to meeting fellow Atlassian users at your local meet up. Learn more about AUGs

Groups near you