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

## Introduction

Permission Schemes allows administrators to determine if the app capabilities will be available for a project's Issues. One Jira project must have at least one permission scheme, or not be associated with a permission scheme (in which case, the app functionality will not be available for that project). 

You can access Permission Schemes, in the [Xporter menu](https://docs.getxporter.app/space/XPORTERCLOUD/558670), by selecting the *Permission Schemes* option (Figure 1 - 1). 

The Permission Schemes screen (Figure 1) displays a list of existing schemes (Figure 1 - 2) and, for each one, the projects associated with it.

![Figure 1 - Permission schemes](media://57e4ceca-8159-447d-a7ea-7ee5ac0af0bd)

## Operations

### [Additions](https://docs.getxporter.app/space/XPORTERCLOUD/528718/Permission+Schemes#Adding-New-Permissions-Schemes)

- Add [new permission schemes](https://docs.getxporter.app/space/XPORTERCLOUD/528718/Permission+Schemes#Adding-New-Permissions-Schemes) by clicking the *Add* button (Figure 1 - 3). When you click this button, a modal will open (Figure 2).
- Copy permission schemes by clicking the gear icon (Figure 1 - 4) and then *Copy* (Figure 1 - 8). A clone of the selected permissions scheme will be created, and made <span style="color: #202124">instantaneously</span> available in the Permission Schemes list (Figure 1).

### [Editing](https://docs.getxporter.app/space/XPORTERCLOUD/528718/Permission+Schemes#Editing-Permission-Schemes)

- [Edit existing permission schemes](https://docs.getxporter.app/space/XPORTERCLOUD/528718/Permission+Schemes#Editing-Permission-Schemes) by clicking the gear icon (Figure 1 - 4), and then select *Edit* (Figure 2 - 5). A modal will open (Figure 3).
- Delete permission schemes by clicking the gear icon (Figure 1 - 4) and then *Delete* (Figure 1 - 9).
- [Define the permissions of the scheme](https://docs.getxporter.app/space/XPORTERCLOUD/528718/Permission+Schemes#Defining-Permissions) by clicking the gear icon (Figure 1 - 4) and then *Permissions* (Figure 1 - 6). A new screen will appear (Figure 4).

### [Defining](https://docs.getxporter.app/space/XPORTERCLOUD/528718/Permission+Schemes#Defining-Permissions)

- See the existing permission schemes (Figure 1 - 2).
- [Select the projects that are associated with a permission scheme](https://docs.getxporter.app/space/XPORTERCLOUD/528718/Permission+Schemes#Associating-Permission-Schemes-with-Projects) by clicking the gear icon (Figure 1 - 4) and then *Projects* (Figure 1 - 7). A modal will open (Figure 5).
- Set the selected permission scheme as default by clicking the gear icon (Figure 1 - 4) and then *Set as Default* (Figure 1 - 10). To remove this status, click the gear icon (Figure 1 - 4) and then *Remove as Default*.

### Adding New Permissions Schemes

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> To add new permission schemes, click the *Add* button (Figure 1 - 3). When you click this button, a modal will open (Figure 2).
> 
> ![Figure 2 - Add new permission schemes](media://81d41116-b3fa-4976-9c42-852cbf96ddea)
> 
> > Macro (rw-step)
> 
> Enter the permission scheme name (Figure 2 - 1; mandatory field) and a description (Figure 2 - 2; optional field).
> 
> > Macro (rw-step)
> 
> Once you're done, click the *Create* button (Figure 2 - 3). The new scheme will be created instantly and you will be able to see it as shown in Figure 1 - 2.

### Editing Permission Schemes

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> To edit a permission scheme, click the *Edit* button (Figure 1 - 5). When you click this button, a modal will open (Figure 3).
> 
> ![Figure 3 - Edit a permission scheme](media://353d0c6a-9dc8-4a25-b6b6-e7cc913e0ec4)
> 
> > Macro (rw-step)
> 
> Edit the permission scheme name (Figure 3 - 1; mandatory field) and the description (Figure 3 - 2).
> 
> > Macro (rw-step)
> 
> Once you're done, click the *Update* button (Figure 3 - 3). The scheme will be updated instantly, and you will be able to see it as depicted in Figure 1 - 1.

### Defining

#### Defining Permissions

> Macro (rw-ui-steps-macro)
> 
> > Macro (rw-step)
> 
> To define the permissions of the Permission Scheme, click the gear icon (Figure 1 - 4) and then *Permissions* (Figure 1 - 6).
> 
> A new screen will appear (Figure 4).
> 
> ![Figure 4 - Defining permissions](media://e2ae8ff1-fcbe-4b54-94dc-d6cc48f2154c)
> 
> > Macro (rw-step)
> 
> Here (Figure 4), you can:
> 
> - See the projects associated with this permission (Figure 4 - 1). You can [change this on the main screen, by clicking the gear icon and then ](https://docs.getxporter.app/space/XPORTERCLOUD/528718/Permission+Schemes#Associating-Permission-Schemes-with-Projects)*[Projects](https://docs.getxporter.app/space/XPORTERCLOUD/528718/Permission+Schemes#Associating-Permission-Schemes-with-Projects)* (Figure 1 - 7).
> - Define:
>   - Which issue types are allowed to be exported (Figure 4 - 2).
>   - Which project roles are allowed to use [Xporter for Jira](https://marketplace.atlassian.com/apps/891368/xporter-export-issues-from-jira?tab=overview&hosting=cloud) (Figure 4 - 3).
>   - Which user groups are allowed to use Xporter for Jira (Figure 4 - 4).
>   - The mapping of issue types to templates. Allows you to associate templates with certain issue types (Figure 4 - 5; 6). For each issue type, only the associated templates will be shown.
> 
> > Macro (rw-step)
> 
> Once you're finished, click the *Confirm* button (Figure 4 - 7).

#### Associating Permission Schemes with Projects

In the *Permission Schemes* screen (Figure 1) click the gear icon (Figure 1 - 4), and then select *Projects* (Figure 2 - 5). A modal will open (Figure 5).

![Figure 5 - Projects](media://edc10eb5-026e-459d-b335-de98cb3f4a40)

Here, you can select the projects (Figure 5 - 1) you want to assign to your permission schemes.

Once you're finished, click the *Confirm* button (Figure 5 - 2).


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