How to customize the "Not Permitted" page

Still need help?

The Atlassian Community is here for you.

Ask the community

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:

  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.
    (info) 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:

<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>



Last modified on Jan 25, 2023

Was this helpful?

Yes
No
Provide feedback about this article
Powered by Confluence and Scroll Viewport.