Page Permissions

Page Permissions

On this page:


Pages within the Wiki are generally open to anyone who has access to the Jira project the page belongs to.

Sometimes however, you have a page with sensitive information you don't want all users to have access to. Things like shared credentials, admin specific notes, and so forth. In those cases, you can protect your pages via built-in page permissions.

 

Permissions Location

To change the permissions of a page, visit the permissions screen either by clicking the lock icon from the page actions, or the permissions icon from the page sidebar.

page view with permissions icons highlighted

 

Who Can Access the Page?

Pages can be marked as open to everyone within the project, or locked to specific users, groups, or roles.

permissions screen - locked

 

Adding Users, Groups and Roles to the Permissions List

Use the typeahead field to search for users, groups, and roles, and use the "Add" button to add them to the list of entities that should have access to this page.

video of user group search

Users with Edit access can perform any action against the page without restriction, including editing the page, archiving it, as well as deleting the page.

Users with only View access can see the page content (attached files, past versions, page history, page activity stream), as well as comment on a page, but not change the page content, or attach new files, or revert to a previous version of a page.

 

Importing Permissions from Another Page

As an added convenience, you can also import permissions from another page using the designated button for it. Use this when you want the new page to have the same permissions as that other page.

Click on the Import from another page button to bring in permission settings from another page.

import from another page button highlighted

NOTE:

The Import from another page function is not available on inherited and shared pages.

 

The Import Permissions Dialog

The Import Permissions dialog gives you options to…

  • set which page you are importing permissions from.

  • replace all existing permissions of the current page with the imported settings from the selected page.

  • merge permissions of the current page and the imported settings.

permissions import dialog

To avoid clutter, the import dialog only lists other pages that actually have permissions set, thus filtering out any "open" pages or “shared” pages.

permissions import dialog

Select a page from the list to view its permissions.

permissions import dialog

Click “X” on the left part of the row to remove permission settings that you don’t want for the current page.

You have the option of either merging permissions entries from the selected page into the permissions you already have for the current page, or to replace all your current permissions with those of the selected page.

TIP!
You don't have to import permissions verbatim. The import dialog allows you to edit the entries, or even remove some, before actually importing.

 

How do I revert a locked page to open?

To revert a locked page back to open, either click the corresponding radio button in the "Who can access this Page" section, or remove all the permissions entries, and save the page.

Conversely, if you try to change a page from open to locked, but don't add any actual users/groups to the list, the page will remain open, as it is not locked to anyone specific.

 

Special Permissions for Admin Users and Page Owners

Locked pages can only be accessed by the designated users, or the users belonging to the designated group. There are 3 special cases to permissions however.

  1. Users in the Jira Administrators group always have read/write access to all pages.
    This exist intentionally, to avoid the possibility of users locking themselves out of a page, or a page being rendered entirely inaccessible.

  1. The owner of a page always has read/write access to a page.
    This is to prevent accidentally locking out the owner.

  1. On Jira Server / Data Center, you can mark a page as publicly accessible.