---
title: "Project - Permission Schemes"
canonical: "https://docs.getxporter.app/space/XPORTERCLOUD/430612/Project%20-%20Permission%20Schemes"
format: markdown
---
> Macro (rw-ui-expands-macro)
> 
> > Macro (rw-expand)
> 
> > Macro (toc)

## Introduction

[<span style="color: #172B4D">Xporter</span>](https://marketplace.atlassian.com/apps/891368/xporter-export-issues-from-jira?tab=overview&hosting=cloud)<span style="color: #172B4D"> allows Jira Project administrators to create and manage Permission Schemes at the Project level.</span>

<span style="color: #172B4D">All features related to </span>[<span style="color: #172B4D">Permission Schemes</span>](https://docs.getxporter.app/space/XPORTERCLOUD/528718/Permission+Schemes)<span style="color: #172B4D"> management on </span>[<span style="color: #172B4D">Xporter App Administration</span>](https://docs.getxporter.app/space/XPORTERCLOUD/460808)<span style="color: #172B4D"> are included at this level of configuration.</span><span style="color: #0d0d0d"> However, users cannot associate projects with the scheme, and it's not possible to set a scheme as default.</span>

> ℹ️ From now on, Project administrators can add, edit, and delete Permission Schemes at the Project level. Consequently, Xporter needs to associate the schemes defined at both the Project and Admin levels, resulting in a new scheme with roles and groups grouped by issue type.

## Accessing Permission Schemes

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> <span style="color: #0d0d0d">Navigate to your Jira Cloud instance and select a project</span> (Figure 1 - 1).
> 
> ![Figure 1 - Project](media://d651ce4f-4542-4e34-b896-cf5a81261916)
> 
> > Macro (rw-step)
> 
> A menu will open on the left side of the screen. There, click the *Project settings* option (Figure 2 - 1).
> 
> ![Figure 2 - Project settings](media://7ed8a030-cede-4134-b627-a3e48ebfd990)
> 
> > Macro (rw-step)
> 
> Another menu will open, on the left side of the screen. There, enter *Apps* (Figure 3 - 1) and then *Xporter* (Figure 3 - 2).
> 
> ![Figure 3 - Apps](media://35cd2ab4-32d7-4a1d-ba09-5ecd4b4e15c4)
> 
> > Macro (rw-step)
> 
> In this screen (Figure 4), you can create/edit [Templates](https://docs.getxporter.app/space/XPORTERCLOUD/430710/Project+-+Templates) (Figure 4 - 1), Permission Schemes (Figure 4 - 2), and [Scheduled Reports](https://docs.getxporter.app/space/XPORTERCLOUD/41222146/Project+-+Scheduled+Reports) (Figure 4 - 3).
> 
> ![Figure 4 - Permission Schemes](media://e1e45d8a-62ca-4f3e-aca5-1119205e78a0)

## Managing Permission Schemes

### No Permission Schemes Defined

If you don't have a Permission Scheme created yet, your screen will look like Figure 4.

Here, you can:

- Click the *Create* button (Figure 4 - 4) to create a new Permission Scheme. Then, follow the instructions [on this page](https://docs.getxporter.app/space/XPORTERCLOUD/528718/Permission+Schemes#Adding-New-Permissions-Schemes).
- Click the *Learn more* button (Figure 4 - 5) to go to the [Xporter Templates documentation](https://docs.getxporter.app/space/XPORTERCLOUD/431152/Templates).
- Use the toggle <span style="color: #111111">(Figure 4 - 6) </span>to <span style="color: #111111">disable/enable global Permission Schemes in the project. </span>

### <span style="color: #111111">Permission Schemes Defined</span>

<span style="color: #111111">If you have Permission Schemes already defined, your screen will look like Figure 5.</span>

![Figure 5 - Permission schemes defined](media://ff23b02c-100a-4f2e-bf0c-66fa39ceeecb)

<span style="color: #111111">Here, you can:</span>

- View the list of the Permission Schemes defined and their details (Figure 5 - 1).
- Click the gear icon (Figure 5 - 2) to edit (name and description), copy, and/or delete an existing Permission Scheme. If you select *Permissons*, a modal will open (Figure 6) for you to <span style="color: #172B4D">define the permissions of a Permission Scheme. </span>This screen is similar to [the one used in the Xporter App Administration](https://docs.getxporter.app/space/XPORTERCLOUD/528718/Permission+Schemes) with some differences:
  - Only issue types and roles available for the selected project can be defined.
  - For each issue type selected, the user can define [project ](https://docs.getxporter.app/space/XPORTERCLOUD/430710/Project+-+Templates)Permission Schemes or global Permission Schemes (when the *Enable Global Permission Schemes *toggle is enabled; Figure 5 - 1).
- Click the *Add* button (Figure 5 - 3) to [add a new Permission Scheme](https://docs.getxporter.app/space/XPORTERCLOUD/528718/Permission+Schemes#Adding-New-Permissions-Schemes).
- <span style="color: #172B4D">Use the toggle</span><span style="color: #172B4D"> </span><span style="color: #111111">(Figure 5 - 4) </span><span style="color: #172B4D">to </span><span style="color: #111111">disable/enable global Permission Schemes in the project.</span>

#### <span style="color: #111111">Editing a Permission Scheme</span>

<span style="color: #111111">To edit an existing permission scheme, click the gear icon (Figure 5 - 2) and then select </span>*<span style="color: #111111">Permissions</span>*<span style="color: #111111">.</span>

![Figure 6 - Editing a permission scheme](media://33efa717-4b4b-4a93-a4bd-b3896ad7f406)

<span style="color: #111111">Here, you can edit the Permission Scheme's:</span>

- <span style="color: #111111">Issue types (Figure 6 - 1).</span>
- <span style="color: #111111">Roles (Figure 6 - 2).</span>
- <span style="color: #111111">Groups (Figure 6 - 3).</span>

<span style="color: #111111">You can also edit the mapping of the issue types to templates (Figure 6 - 4).</span>

<span style="color: #111111">Once you're done, click the </span>*<span style="color: #111111">Confirm</span>*<span style="color: #111111"> button (Figure 6 - 5) to save the changes.</span>

## Permission Schemes - Examples

### "Developers" (created by a a project administrator)

![Figure 7 - Permission scheme developers](media://283d5523-f640-4688-a941-0932251ddd2b)

#### Result

User can export tasks and bugs if the Permission Scheme respects one of these conditions:

- Has the *adminstrator* role (Figure 7 - 1).
- Belongs to the *atlassian-addon-admin* group (Figure 7 - 2).

> ℹ️ In this scenario (Figure 8), it's only possible to export in a single issue because the issue types defined (Figure 7 - 3) don't have a common template (Figure 7 - 4).

### Multiple Permission Schemes

Schemes created by a JIRA administrator merge with those created by project administrators.

Users with different roles and group affiliations can export specific issue types, based on the merged schemes.

In Figure 8, you can see a scheme and the result of merging it with the one above (Figure 7).

#### "Administrators" (created by a JIRA administrator)

![Figure 8 - Permission scheme administrators](media://4a93b299-d1ad-4694-8fa7-5c74179f9c51)

##### Result

- Users who have *Administrator* and *Developers* roles (Figure 8 - 2) and or belong to *atlassian-addons-admin* and *confluence-users* groups (Figure 8 - 3) can export issues of type *bug*, *task* or *story *(Figure 8 - 1).
- Users who have the *administrators* role (Figure 8 - 2) can only export tasks or bugs (Figure 8 - 1).
- Users that belong to both groups (Figure 8 - 3) can export *tasks*, *bugs*, or *stories *(Figure 8 - 1)*.*

> ℹ️ In this scenario, exporting multiple issues of different types is restricted due to the lack of common templates.


<details>
<summary>Support/Troubleshooting</summary>

If you have questions or technical issues, please [contact the Support team via the Customer Portal (Jira service management)](https://jira.getxray.app/servicedesk/customer/portal/2/user/login?destination=portal%2F2%2Fcreate%2F28) or [send us a message using the in-app chat](https://docs.getxporter.app/space/XPORTERCLOUD/18251779/In-App+Chat+Support).
</details>