How to customize the "Not Permitted" page

Platform Notice: Data Center Only - This article only applies to Atlassian products on the Data Center platform.

Note that this KB was created for the Data Center version of the product. Data Center KBs for non-Data-Center-specific features may also work for Server versions of the product, however they have not been tested. Support for Server* products ended on February 15th 2024. If you are running a Server product, you can visit the Atlassian Server end of support announcement to review your migration options.

*Except Fisheye and Crucible

Summary

Product customizations are outside of Support scope as described on the Atlassian Support Offerings Page. For in-depth customization requests, please refer to our Developer Network or Atlassian Partners.

This page gets you started on customizing the Confluence "Not Permitted" page with your own logo or custom text.

The contents covered in this page will not change the actual permission process, but what end users see when they try to access Confluence without user permissions (Eg. a Jira user which is not a member of the confluence-users group).

(Auto-migrated image: description temporarily unavailable)

Solution

We recommend testing the changes on a Test instance before applying them to Production.

Customize the .vmd file:

  1. Navigate to the <Confluence-Install>/confluence directory.

  2. Locate and backup the notpermitted.vm file.

  3. Edit the file with a text or code editor to make your changes.

    ℹ️ Please note: the template contains a mix of HTML markup and Velocity content, see Velocity Template Overview (in our developer documentation) for more information.

  4. Refresh the page. You may need to clear your browser's cache.

Here's an example with a simple text added on line 13:

1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 <html> <head> <title>$action.title</title> <meta name="decorator" content="atl.general"> $webResourceManager.requireResourcesForContext("error.page") </head> <body> #parse ( "/breadcrumbs.vm" ) <div id="content" class="access-error-container $action.cssClass"> <div class="access-error"> <h2>$action.title</h2> <p>$action.message</p> <p>Contact <b>Charlie of Atlassian</b> (charlie@atlassian.com) for requesting access to Confluence.</p> </div> </div> </body> </html>

Updated on April 11, 2025

Still need help?

The Atlassian Community is here for you.