Documentation - aqua cloud
🇬🇧 English
🇬🇧 English
  • 💻Web client
    • Getting started
    • General
      • Home page
      • App language
      • User account
      • Change password
      • Shortcuts & Accessibility
    • How to Contact Our Support
  • 👩‍🔧Administration
  • User administration
    • Adding and editing user profile
    • Roles and permissions
    • Assign, unassign or change licenses
      • Comparison of Licenses
    • Assign/unassign projects and roles
    • Licenses statistics
    • Statistics
  • Project configuration
    • [NEW] Project template configuration (fields)
      • Shared value sets
    • [OLD] Project template configuration (fields)
      • Shared value sets
      • Creating field groups
    • Field rules
    • [NEW] Workflow configuration
      • Global rules
      • Status and transitions
    • [OLD] Workflow configuration
    • Additional project settings
    • Project integrations
    • System log
    • Email notifications
      • Project default notifications
      • My notifications
      • Configuration of the project notification templates
      • Troubleshooting
  • Projects and folders
    • Project wizard
    • Projects
      • Export project
      • Import project
        • Migration from Testrail
      • Archive project
    • Folders
      • Export project folder
      • Import project folder
  • 🧩Modules
  • Navigation page
    • Project tree
    • Items grid
    • Filtering and grouping
    • Views
    • Search
    • Preview item details
  • Items
    • Requirements management
      • Requirements
      • Subrequirements
      • Requirements coverage
    • Test cases management
      • Test cases
      • Nested test cases (shared test cases/steps)
      • Manual testing
      • Test data or Variables manager
      • Test environment tracking with labels (tags)
      • Test execution results
      • Test automation
      • Capture: Test recorder/bug reporter
      • Test it: easy way to start run
      • Quick run: test execution of multiple test cases at once
    • Test scenarios management
      • Test scenarios
      • Adding test cases to a test scenario
      • Executing test scenarios
    • Defects management
      • Defects
      • Creating a defect from a test execution
      • Review found or linked defects to the test execution
      • Creating a defect with Capture
    • General item capabilities
      • Creating and Editing Items
      • Copy item to a target project or duplicate within a project
      • Taking over field values between items
      • Item template (defaults)
      • Dependencies
      • Add links to a description
      • Take screenshots
      • Watch item and notify other users
      • Attachments (files)
      • History of changes
      • Discussions (comments)
      • Print item data
  • Reporting
    • Creating a new report template
    • Basic report elements
    • Element tree structure
    • Element properties
    • Diagrams
    • Pivot table
    • 'Sum' function
    • Creating custom report script
    • Parametrization of reports
    • Exclude empty items from a report
    • Adding table of contents to a report
    • How to filter executions based on custom added fields?
  • Dashboards
    • Creating a dashbord
    • Publishing the dashboard
    • Creating a chart
    • KPI alerts
    • Drilldown to details from a chart
    • Burndown chart template
  • Agile
    • Backlog
    • Sprint board
    • Preview
  • 🖥️Desktop client
    • Getting started
      • Important notice: Deprecation of the desktop client in June 2025 [updated]
      • FAQ: Transitioning from the desktop client to the web Client
      • Desktop installation
      • Home screen configuration
      • Views
      • Grid
    • Agile board
      • Burn Down Chart
    • Dashboard
    • User Administration
      • Adding and managing users
      • Roles and permissions
      • Assigning licenses projects and roles
      • Statistics
    • Project configuration
      • Configuration of Fields and Workflows
      • Email Notification
      • Change company logo in printout
      • Import Project Configuration
    • Import / Export Wizard
    • Project Planner
      • Creating and editing a new project plan
      • Adding and syncing items to project plan
      • Resource planning
      • Gates and Stages
    • Requirements Management
      • Dependency
      • Subrequirements
      • Mind map
      • Comments
      • Documents
    • Test Management
      • Step Designer
      • Test Execution
        • Autosave of a test execution
      • Variable Manager
      • Nested Testcases
      • Disable manual test execution time
    • Test Scenarios
      • Test Scenarios
      • Scheduled Executions of Test Scenarios
      • Run Dependency
    • Defect Management
    • Reporting
      • Creating a Report
      • Creating a new report template
      • The Report Wizard
      • Basic Report Elements
      • Element tree structure
      • Element Properties
      • Diagrams
      • Pivot Table
      • Sum Function
      • Script Development
      • Parametrization
      • Performance Improvements for Report Creation
      • Remove empty elements
      • Table of Contents
      • Invalid References
    • Agile Board
      • Configuring the Agile Component
      • Planning board
      • Scrum board
      • Burn Down Chart
    • Versioning
  • 💿Installation for on premise
    • System Requirements
      • Server
      • Desktop Client
      • Web Client
      • Agents
    • Server Installation
    • Server parameters
    • Web Client Installation
    • Getting Agents
    • Connection to MSSQL Database
    • Connection to Oracle Database 12.2c
    • Licenses
    • Monitoring
    • SSL-Configuration
    • Content Security Policy (CSP) Settings
  • 🪄AI Copilot
    • Transform your testing and project management with aqua's AI Copilot
    • Enable and manage AI Copilot options
    • Create documents with ease with AI Copilot
    • AI Copilot: generate a comprehensive description for the test cases in just one click
    • AI Copilot - create test cases out of requirements or based on context in seconds
      • Create test cases from the navigation page
      • Create test cases from a requirement
      • Create a test case from a test case page
    • Generate test data with AI Copilot
    • Generate test case based on a file
    • Generate test cases in BDD format
    • Generate test cases with AI Copilot using test design techniques
    • Create user stories, BDDs, or PRDs based on a file
    • Create multiple user stories or BDDs with AI Copilot
    • Split or convert requirements
    • AI Copilot chat
  • 🔗Integrations
    • Jira sync: synchronize items between aqua and Jira projects
      • Before you begin: key steps for synchronization
      • Sync configurator set up
        • Sync Configurator options
      • Log in to the Sync Configurator
      • Sync of the projects between aqua and Jira
      • Fields mapping
        • Supported default Jira fields
        • General aqua and Jira fields compatibility
        • Special compatibility for aqua and Jira fields
      • Additional settings
        • Allow mapping of only selected values and ignore other field values for the sync
        • Automatic creation and mapping of field values
      • Troubleshooting
      • Synchronisaton of subtasks with aqua
      • Formatting support
    • Azure Devops sync
    • Jira link: create and/or link Jira issues to aqua tickets
    • aqua4Jira plugin: Cover Jira issue with aqua test cases
      • Installation of the plugin
        • aqua4Jira Plugin - Now Compatible with Jira Data Center!
      • Configuration in Jira
      • Configuration in aqua
    • Automatic display of test cases or test scenarios in Jira tickets
    • Confluence integration
    • Capture: record tests or create comprehensive bug reports
    • Testlink: importer tool for migrating test cases to aqua
    • SSO
      • LDAP
      • SAML Configuration
        • Installation
        • Sample
  • 🌀Automation
    • Desktop Client
      • Creating an Automation Agent
      • Configure Automation
      • Ranorex
      • UFT
      • JMeter
      • SoapUI
      • Database
      • UnixShell
      • PowerShell
      • Automation Library
    • Web Client
      • Automation Agent
        • Creation & Configuration
        • Agent pools
        • Running task
      • Powershell
      • Unix Shell
      • Jenkins integration
      • Selenium
    • REST API
    • Automation: CI/CD tools and aqua REST API
      • Gitlab CI/CD: JAVA/Playwright
      • Gitlab CI/CD: TypeScript/Cypress
      • Gitlab CI/CD: TypeScript/Playwright
      • Gitlab CI/CD: TypeScript/Cypress/Cucumber
  • 🚀Product updates for on premise customers
    • Product updates
      • 25.56.0 - On Premise
      • 25.52.0 - On Premise
      • 25.47.0 - On Premise
      • 25.36.0 - On Premise
      • 25.31.0 - On Premise
      • 25.18.0 - On premise
      • 25.10.0 - On Premise
      • 24.135.0 - On Premise
      • 24.130.0 - On Premise
      • 24.126.0 - On Premise
      • 24.108.0 - On Premise
      • 24.101.0 - On Premise
      • 24.93.0 - On Premise
      • 24.83.0 - On Premise
      • 24.71.0 - On Premise
      • 24.53.0 - On Premise
      • 24.8.0 - On Premise
      • 23.140 - On Premise
      • 23.126.0 - On Premise
      • 23.102.0 - On Premise
      • 23.70.0 - On Premise
      • 23.22.0 - On Premise
      • 22.132.0 - On Premise
      • 22.123.0 - On Premise
    • Release Notes
      • 25.56.0 - On premise
      • 25.52.0 - On premise
      • 25.47.0 - On Premise
      • 25.36.0 - On Premise
      • 25.31.0 and 25.33.0 - On Premise
      • 25.26.0 - On Premise
      • 25.18.0 - On Premise
      • 25.10.0 - On Premise
      • 24.135.0 - On Premise
      • 24.130.0 - On Premise
      • 24.126.0 - On Premise
      • 24.114.0 - On Premise
      • 24.108.0 - On Premise
      • 24.101.0 - On Premise
      • 24.93.0 - On Premise
      • 24.83.0 - On Premise
      • 24.71.0 - On Premise
      • 24.53.0 - On Premise
      • 24.8.0 - On Premise
      • 23.140.0 - On Premise
      • 23.126.0 - On Premise
      • 23.102.0 - On Premise
      • 23.70.0 - On Premise
      • 23.22.0 - On Premise
      • 22.132.0 - On Premise
      • 22.123.0 - On Premise
  • 🚀Product updates for public and private clouds customers
    • Product updates
      • 25.56.0 - public and private cloud
      • 25.52.0 - public and private cloud
      • 25.47.0 - public and private cloud
      • 25.36.0 - public and private cloud
      • 25.33.0 - public and private cloud
      • 25.18.0 - public and private cloud
      • 25.10.0 - public and private cloud
      • 24.135 - public and private clouds
      • 24.130 - public and private clouds
      • 24.126.0 - public and private clouds
      • 24.108.0 - public and private clouds
      • 24.101.0 - public and private clouds
      • 24.93.0 - public and private clouds
      • 24.88.0 - public and private clouds
      • 24.83.0 - public and private clouds
      • 24.71.0 - public and private clouds
      • 24.63.0 - public and private clouds
      • 24.50.0 - public and private clouds
      • 24.33.0 - public and private clouds
      • 24.8.0 - public and private clouds
      • 23.140 - public and private clouds
      • 23.126.0 - public and private clouds
      • 23.107.0 - public and private clouds
      • 23.92.0 - public and private clouds
      • 23.70.0 - public and private clouds
      • 23.46.0 - public and private clouds 1/3
      • 23.46.0 - public and private clouds 2/3
      • 23.46.0 - public and private clouds 3/3
      • 23.22.0 - public and private clouds
      • 22.132.0 - public and private clouds
    • Release notes
      • 25.56.0 - public and private cloud
      • 25.52.0 - public and private cloud
      • 25.47.0 - public and private cloud
      • 25.36.0 - public and private cloud
      • 25.33.0 - public and private cloud
      • 25.31.0 - public and private cloud
      • 25.24.0 - public and private cloud
      • 25.18.0 - public and private cloud
      • 25.10.0 - public and private cloud
      • 24.135.0 - public and private clouds
      • 24.130 - public and private clouds
      • 24.126.0 - public and private clouds
      • 24.114.0 - public and private clouds
      • 24.108.0 - public and private clouds
      • 24.101.0 - public and private clouds
      • 24.93.0 - public and private clouds
      • 24.88.0 - public and private clouds
      • 24.83.0 - public and private clouds
      • 24.71.0 - public and private clouds
      • 24.63.0 - public and private clouds
      • 24.50.0 - public and private clouds
      • 24.33.0 - public and private clouds
      • 24.8.0 - public and private clouds
      • 23.140.0 - public and private clouds
      • 23.126.0 - public and private clouds
      • 23.107.0 - public and private clouds
      • 23.92.0 - public and private clouds
      • 23.70.0 - public and private clouds
      • 23.46.0 - public and private clouds
      • 23.22.0 - public and private clouds
      • 22.132.0 - public and private clouds
      • 22.123.0 - public and private clouds
    • 📢AQUA NEWS
      • Upcoming new storage options for On-premise deployments
      • 🔒 Rate Limits for Public Cloud Users
      • Preview of aqua's public API
      • aqua is now ISO 27001 certified and DORA Compliant
      • Upcoming changes to aqua API
      • AI Copilot launching for All public clouds users on January 27th!
  • 📹Capture
    • What is Capture?
    • Chrome extension installation
    • Capturing in Incognito mode
    • Using Capture with Edge
    • Capturing with video
      • Option to enable mic when capturing a screen and adding voice notes
      • Option to pause/resume while capturing the video
        • Masking sensitive information while capturing
    • Capturing with screenshot
    • Running a test execution
    • Last minute session replay
    • Masked inputs while creating captures
Powered by GitBook
On this page
  • Add or Edit Roles
  • Permission Overview

Was this helpful?

  1. User administration

Roles and permissions

PreviousAdding and editing user profileNextAssign, unassign or change licenses

Last updated 2 months ago

Was this helpful?

Add or Edit Roles

To define or edit roles, navigate to User Management and select Roles on the left-hand side. You can then add, copy, change or delete roles.

To change a role, select it from the list or type its name in the search bar. You can then set or remove permissions. Some of these can be enabled as Assigned or Owned. If you select Assigned, the user is allowed to change the items they are assigned to. If you select Owned, the user is allowed to change items that they have created.

For example, if you define a Developer role for users who should only be able to edit defects that are assigned to them, you would select Assigned in Defect Management - Edit Items and Delete Items.

The option 'Permissions from Licence' allows you to define a role based on a specific licence, if required. This allows you to analyse whether a set of permissions fits a particular licence.

Permission Overview

Below is an overview of the permissions you can set and a brief description.

Section

Permission Name

Description

Requirement management

In this section you can set permissions regarding requirements

View

In this section you can set permissions regarding the view

View items

Allows the user to open requirements

View UML

Allows the user to open UMLs (in the rich client)

Generate test cases from UML

Allows the user to automatically generate test cases from an UML (in the rich client)

Use discussions

Allows the user to see the discussion area and add texts there

Export to Word

Allows the user to export requirements to a Word document (in the rich client)

Create

In this section you can set permissions regarding creation

Create items

Allows the user to create new requirements

Create UML

Allows the user to create new UMLs (in the rich client)

Create comments

Allows the user to create comments in the description of the requirement

Import from Word

Allows the user to import requirements from word (in the rich client)

Edit

In this section you can set permissions regarding editing

Edit state

Allows the user to change the status of a requirement

Edit fields

Allows the user to edit fields in the metadata

Edit description

Allows the user to edit the description of a requirement

Edit comments

Allows the user to edit existing comments

Edit UML

Allows the user to change existing UMLs (in the rich client)

Import from Word

Allows to import a description from a Word-File (in the rich client)

Batch edit items

Allows to batch change requirements

Delete

In this section you can set permissions regarding deletion

Delete items

Allows the user to delete requirements

Move

In this section you can set permissions regarding moving items

Move requirements in project

Allows the user to move requirements within one project

Move requirements between projects

Allows the user to move requirements between different projects

Dependencies

In this section you can set permissions regarding dependencies

Create dependencies

Allows to create new dependencies

Delete dependencies

Allows to delete existing dependencies

Defect Management

In this section you can set permissions regarding defects

View

In this section you can set permissions regarding requirements

View items

Allows the user to open defects

Create

In this section you can set permissions regarding creation

Create items

Allows the user to create new defects

Edit

In this section you can set permissions regarding editing defects

Edit items

Allows the user to change defects

Edit enclosures

Allows the user to add or change enclosures

Batch edit items

Allows to batch change defects

Delete

In this section you can set permissions regarding deletion of defects

Delete items

Allows the user to delete defects

Delete enclosures

Allows the user to delete enclosures of defects

Move

In this section you can set permissions regarding moving defects

Move defects in project

Allows the user to move defects within one project

Move defects between projects

Allows the user to move defects between different projects

Dependencies

In this section you can set permissions regarding dependencies

Create dependencies

Allows to create new dependencies

Delete dependencies

Allows to delete existing dependencies

Test case management

In this section you can set permissions regarding test cases

View

In this section you can set permissions regarding the view

View items

Allows the user to open test cases

Create

In this section you can set permissions regarding creation

Create items

Allows the user to create new test case

Use variable manager

Allows the user to parameterize tests using the variable manager

Nesting test cases

Allows the user to nest a test case within a test step

Test automation

Allows the user to use the automation tab to add new scripts

Edit

In this section you can set permissions regarding editing

Edit status

Allows the user to change the status of a test cases

Edit fields & description

Allows the user to edit fields in the metadata and the description

Edit test steps

Allows the user to use the step designer

Use variable manager

Allows the user to change variables in variable manager

Nesting test cases

Allows the user to change nested test cases

Test automation

Allows the user to change test scripts in test steps

Batch edit items

Allows to batch change test cases

Delete

In this section you can set permissions regarding deletion

Delete items

Allows the user to delete test cases

Move

In this section you can set permissions regarding moving test cases

Move test cases in project

Allows the user to move test cases within one project

Move test cases between projects

Allows the user to move test cases between different projects

Dependencies

In this section you can set permissions regarding dependencies

Create dependencies

Allows to create new dependencies

Delete dependencies

Allows to delete existing dependencies

Test scenario management

In this section you can set permissions regarding test scenarios

View

In this section you can set permissions regarding the view

View items

Allows the user to open test scenarios

Create

In this section you can set permissions regarding creation

Create items

Allows the user to create new test scenarios

Edit

In this section you can set permissions regarding editing

Edit items

Allows the user to change test scenarios

Batch edit items

Allows to batch change test scenarios

Delete items

Allows the user to delete test scenarios

Move

In this section you can set permissions regarding moving test scenarios

Move test scenarios in project

Allows the user to move test scenarios within one project

Move test scenarios between projects

Allows the user to move test scenarios between different projects

Dependencies

In this section you can set permissions regarding dependencies

Create dependencies

Allows to create new dependencies

Delete dependencies

Allows to delete existing dependencies

Test execution

In this section you can set permissions regarding test execution

Test Case

In this section you can set permissions regarding test case executions

Execute tests manually

Allows the user to manually execute test cases

Execute automated tests

Allows the user to execute test cases which contain an automation

Test Scenario

In this section you can set permissions regarding test scenario executions

Execute test scenarios manually

Allows the user to manually execute test scenarios

Execute automated test scenarios

Allows the user to execute test scenarios which contain an automation

Schedule executions

Allows the user to set up schedules for regularly executed test scenarios

Execution status

In this section you can set permissions for the execution status

Finalize test executions

Allows the user to finalize an execution

Set relevance of test executions

Allows the user to mark and unmark executions as (ir)relevant

Automation script management

In this section you can set permissions regarding test automation scripts (in the rich client)

View

In this section you can set permissions regarding the view

View items

Allows the user to open scripts

Create

In this section you can set permissions regarding creation

Create items

Allows the user to create new scripts

Edit

In this section you can set permissions regarding editing scripts

Edit items

Allows the user to edit scripts

Batch edit items

Allows to batch change scripts

Delete items

Allows the user to delete scripts

Move

In this section you can set permissions regarding moving scripts

Move scripts in project

Allows the user to move scripts within one project

Move scripts between projects

Allows the user to move scripts between different projects

Dependencies

In this section you can set permissions regarding dependencies

Create dependencies

Allows to create new dependencies

Delete dependencies

Allows to delete existing dependencies

General

In this section you can set permissions regarding various topics

Views

In this section you can set permissions regarding filtered views

Publish views in project gallery

Allows the user to publish views (including filter, sorting etc.) in the project gallery

Edit public views in project gallery

Allows the user to edit public views (including filter, sorting etc.) in the project gallery

Project configuration

In this section you can set permissions regarding the project configuration

Edit project tree

Allows the user to add, delete and edit folders and sub folders of a project

Configure project

Allows the user to add new projects and change the project configuration

Configure user assignments

Allows the user to assign users to his projects and see, edit and delete all users in his own projects and assign licenses

Configure sub template

Allows the user to configure the sub template of a project (in the rich client)

View all users

Allows the user to see all other users and create, edit or delete users and assign projects and licenses

Notifications

In this section you can set permissions regarding notifications

Configure & receive notifications

Allows the user to configure notifications and receive them

Mind Map

In this section you can set permissions regarding Mind Maps (in the rich client)

View Mind Map

Allows the user to see Mind Maps

Use Mind Map

Allows the user to edit and create Mind Maps

Attachments

In this section you can set permissions regarding attachments

View & open attachments

Allows the user to see attached files

Add attachments

Allows the user to add files

Delete attachments

Allows the user to delete attachments

Export and import

In this section you can set permissions regarding import & export of items

Export items

Allows to export items

Import items

Allows to import items

Project Planner

In this section you can set permissions regarding the project planner (in the rich client)

View items

Allows the user to see project plans

Report work

Allows the user to report work on items in the project plan

Create / edit / delete items

Allows the user to create / edit / delete items in the project plan

Show earned value analysis

Allows the user to see the earned value analysis of a project plan

Dashboard

In this section you can set permissions regarding the dashboard

View dashboard

Allows the user to see the dashboard

Edit dashboard

Allows the user to add new charts or change visible charts

Publish charts

Allows the user to save charts in the chart gallery

Edit public charts

Allows the user to change saved charts

Agile

In this section you can set permissions regarding Agile planning (in the rich client)

View agile board

Allows the user to see the agile board

Create and edit sprints

Allows the user to create new sprints and edit existing ones

Delete sprints

Allows the user to delete sprints

Sprint planning

Allows the user to access the sprint planning

Reporting

In this section you can set permissions regarding reporting

Base

In this section you can set permissions regarding basic reporting

Use reporting

Allows the user to see the report section

Manage existing report templates

Allows to import/export report templates as well as to configure properties

Create new report templates and edit layouts

Allows the user to create new reports and edit existing ones

Export

In this section you can set permissions regarding export reports

Export to PDF

Allows the user to export reports to PDF format

Export to HTML

Allows the user to export reports to HTML format

Export to MHT

Allows the user to export reports to MHT format

Export to RTF

Allows the user to export reports to RTF format

Export to XLS

Allows the user to export reports to XLS format

Export to XLSX

Allows the user to export reports to XLSX format

Export to CSV

Allows the user to export reports to CSV format

Export to Text File

Allows the user to export reports to Text File

Export to Image File

Allows the user to export reports to Image File

Export to DOC

Allows the user to export reports to DOC format

Export to DOCX

Allows the user to export reports to DOCX format

Export to ODT

Allows the user to export reports to ODT format

Sign exported reports (PDF)

Allows the user to sign reports which are exported as PDF

Editing roles
Assigned vs Owned
Permissions from license