How to customize the "Not Permitted" page
Platform Notice: Data Center - This article applies to Atlassian products on the Data Center platform.
Note that this knowledge base article was created for the Data Center version of the product. Data Center knowledge base articles 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
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.
Purpose
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).
Solution
We recommend testing the changes on a Test instance before applying them to Production.
Customize the .vmd file:
- Navigate to the <Confluence-Install>/confluence directory.
Locate and backup the notpermitted.vm file.
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.- Refresh the page. You may need to clear your browser's cache.
Here's an example with a simple text added on line 13:
<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>