You can customize user permissions required to access Vansah functions by using Jira groups. This allows you to restrict project functions like "Create Test Cases" or "View Test Case" to Jira Groups in your workspace.
Where to Find Group Permissions
Access Vansah Space Settings
As a Jira Space Administer:
Open Vansah from your Jira Space.
Click the Settings icon (gear ⚙️) in the top-right corner.
Select Space under Vansah Settings.
Assign Jira Groups to Vansah Functions
Once in Space Settings, select Permissions from the left-hand menu.
You will see a list of available Vansah permissions like:
Manage Space Settings
View Work Item Screen
Vansah Intelligence
Create/Edit Test Cases
Under the Jira Group column, use the dropdown to select one or more groups for each permission
Note: Once you assign a group to a Vansah function, the default Jira permissions required is overridden, and only the selected groups will be allowed to perform that function.
Jira Groups for Vansah Functions
Using Jira groups allows you to control which users in your organization can access specific Vansah functions for a Jira space. As soon as you assign one or more groups to a Vansah function, it replaces the default Jira permissions requirement for that function.
This means only users in the selected Jira group(s) will be able to use that Vansah feature giving you more targeted control over space access.
Example
If you assign the Jira group system-administrators and jira-software-users-vansah
to the View Test Case permission, only users in that group will be able to view Test Cases for your Jira space.
Default Jira Permissions when no Group (s) selected
By default, Vansah relies on the Jira permissions listed in the table below to determine whether a space user can perform specific Vansah functions.
This means, if no Jira Group (s) have been selected against the function, Vansah checks a user's access based on their existing Jira permission as shown in table below.
Note: To manage Vansah Space Settings (#1 in Table) all users must have Administer Space Jira permission irrespective of which group they belong to. This is a Jira limitation. (We are working to resolve this with Atlassian to by pass this requirement).
# | Function | Jira Permission * If no Jira Group specified | Creator * Allow Creator | Description |
1 | Manage Space Settings | Administer Space
| - | Allows users to configure Vansah Space settings such as environments, custom fields, permissions, and statuses.
NOTE: * (All users Must have Jira “Administer Space” permission irrespective of any Jira group selected) |
2 | View Work item Screen | Browse spaces | - | Grants users permission to view Vansah in the Jira Work Item screen. |
3 | Vansah Intelligence (AI) | Browse spaces | - | If Enabled access to Vansah all Intelligence AI features. |
4 | View Test Case | Browse spaces | - | Allows viewing of all Test Cases within the spaces. |
5 | Link & Unlink Test Cases | Browse spaces | - | Allows linking or unlinking of test cases to Jira work items, Test Plans, or Folders. |
6 | Create Test Cases | Browse spaces | - | Allows creation of new Test Cases |
7 | Edit Test Case | Browse spaces | ✅ | Allows editing of existing Test Cases including steps, data, and attachments. |
8 | Delete Test Case | Delete Work Item , Administer Space | ✅ | Allows deletion of Test Cases from the space. |
9 | Delete Test Plan | Delete Work Item , Administer Space | ✅ | Allows deletion of an entire Test Plan. |
10 | Delete Test Plan Iteration | Delete Work Item , Administer Space | ✅ | Allows deletion of specific Test Plan iterations. |
11 | Delete Test Folder | Delete Work Item , Administer Space | ✅ | Allows deletion of Test Folders and all contained Test Cases. |
12 | Delete Recycle Bin (Permanently) | Bulk Change , Administer Space, Delete Work Item | - | Allows permanent removal of items from the Vansah Recycle Bin. |
13 | Delete Test Case Attachments | Administer Space , Delete Work Item | ✅ | Allows deletion of attachments associated with Test Cases. |
14 | Import Test Cases | Bulk Change , Administer Space, Delete Work Item | - | Allows importing Test Cases from CSV, XLSX, or JSON formats. |
15 | Import Test Case Results | Bulk Change , Administer Space, Delete Work Item | - | Allows importing of Test Execution results. |
16 | Export Test Cases | Bulk Change , Administer Space, Delete Work Item | - | Allows exporting Test Cases to supported formats. |
17 | Execute Test Cases | Browse spaces | - | Grants permission to execute Test Runs and record results. |
18 | View Vansah Board | Browse spaces | - | Allows viewing of Vansah Boards and Test Execution dashboards. |
19 | Access Recycle Bin | Browse spaces | - | Allows viewing and restoring deleted items from the Vansah Recycle Bin. |
20 | Delete Test Run/Test Plan Attachments | Delete Work Item , Administer Space | ✅ | Allows deletion of attachments added to Test Runs or Test Plans. |
21 | Add new Test Case Label | Browse spaces | - | Allows adding or creating new labels for categorizing Test Cases. |
22 | View Reports | Browse spaces | - | Allows viewing of test and execution reports. |
23 | Create & Clone a Report | Browse spaces | - | Allows creating new reports or cloning existing ones. |
24 | Edit a Report | Browse spaces | ✅ | Allows editing existing reports to update filters, visuals, or metrics. |
25 | Delete a Report | Browse spaces | ✅ | Allows deleting a report from Vansah. |
26 | Share a Report | Browse spaces | ✅ | Allows sharing reports with other users or groups. |
27 | Stop Report Sharing | Administer Space | ✅ | Allows revoking shared access to reports. |
28 | Delete Test Run | Delete Work Item , Administer Space | ✅ | Allows deleting completed or in-progress test runs. |
29 | Create Test Folders | Browse spaces | - | Allows users to create new test folders to organise test cases. |
30 | Edit Test Folder | Browse spaces | ✅ | Allows renaming or restructuring existing test folders. |
31 | Create Test Plans | Browse spaces | - | Allows creation of new test plans for grouping and managing executions. |
32 | Clone Test Folder | Browse spaces | - | Allows duplication of existing Test Folders including nested cases. |
33 | Clone Test Case | Browse spaces | - | Allows creating a copy of an existing Test Case. |
34 | Create Test Plan Folders | Browse spaces | - | Allows creation of folders within the Test Plans area for organisation. |
35 | Edit Test Plan Folder | Browse spaces | ✅ | Allows renaming or restructuring of existing Test Plan folders. |
36 | Delete Test Plan Folders | Browse spaces | ✅ | Allows deletion of folders within the Test Plans area. |
37 | API Tokens | Browse spaces | - | Allows creation of personal Vansah API Tokens. |
38 | Create Test Case Version | Browse spaces | - | Allows the user to create a new version of a Test Case. Users without this permission cannot generate Test Case versions. |
39 | Edit Test Case Version | Browse spaces | ✅ | Allows the user to modify version properties such as Version name, Default Version and Active Version. |
40 | Archive/Restore Test Case Version | Browse spaces | ✅ | Allows the user to archive an existing version or restore a previously archived one. Controls lifecycle transitions of Test Case versions. |
41 | View Test Environments | Browse spaces | - | Grants the ability to view and access all Test Environments that exist within the spaces. |
42 | Create Test Environments | Browse spaces | - | Allows users to create new Test Environments. |
43 | Edit Test Environment | Browse spaces | - | Allows users to update or modify Test Environment details. |
44 | Delete Test Environment | Browse spaces | - | Allows users to permanently delete a Test Environment. |
45 | Create Test Data Collection | Browse spaces | - | Allows users to create a new Test Data Collection. |
46 | Edit Test Data Collection | Browse spaces | ✅ | Allows users to modify Test Data Collection items and metadata. |
47 | Clone Test Data Collection | Browse spaces | ✅ | Allows users to duplicate an existing Test Data Collection for reuse. |
48 | Delete Test Data Collection | Browse spaces | ✅ | Allows users to delete an existing Test Data Collection. |
Managing Master Permissions Template
You can save your preferred permissions which should be applied to your Jira spaces. This will ensure that any new Jira space with Vansah enabled will automatically inherit the permissions you have selected.
Update Master Permissions:
Go to any Jira space and access Vansah permissions for the space.
Configure Your Permissions (if needed)
Adjust the group access by using the dropdowns next to each permission (e.g.,
Manage Project Settings,View Test Case, etc.).Use the “Choose Groups” dropdown to assign Jira groups for each permission.
Open More Options
In the top-right corner of the permissions list, click the three vertical dots (⋮) to open more options.
Click “Update Master Permissions”
From the dropdown menu, select “Update Master Permissions”.
Select Update to confirm: This action will save your current permission settings as the master template, which can be reused across other space.
Note: New Jira space will now automatically load the Master Vansah permissions template.
To Load Master permissions:
From the dropdown menu, click on “Load Master Permissions”.
This will overwrite your current project’s permission settings with the saved Master Permissions template.
Common Errors
Error : "You do not have the required permission"
If you encounter the error "You do not have the required permission", please contact your Jira Administrator and request them to add you to the appropriate user group that has access to the Vansah Board or grant you access to the requested Vansah page.
Error : "You do not have the correct permissions to view the page"
To resolve this issue, please ensure that you are added to the space. You may add yourself or request your Jira Administrator to add you under Space Settings → People, with an appropriate access role (e.g., Space Role or User).