Configure Jira Project Settings

Applies to Zephyr Scale Server/Data Center 9.1, last modified on September 26, 2023

Project-level settings allow you to customise characteristics of Zephyr Scale projects within your Jira. Some projects should have different permissions/restrictions, issue types, and traceability-link schemes, which you can adjust project by project, as needed.

Note: You must be a project admin to change Jira project settings.

Access Jira project settings

  1. Click the gear icon in the upper-right corner of the screen, then click Projects.

  2. Click on a project for which you’d like to access settings.

  3. Scroll down the page, and click Zephyr Scale in the panel on the left side of the page.

    Project access settings

    Click the image to enlarge it.

Enable/disable the app

Use this setting to enable or disable Zephyr Scale.

Disabling Zephyr Scale projects does not delete data.

Enabling Zephyr Scale

Click the image to enlarge it.

Enable/disable issue types

Use this section to enable/disable specific issue types for the project.

The 'Issue types' screen


If enabled, settings configured in the Permissions section are active for the selected project. If disabled, all users who can view the project are able to perform all Zephyr Scale actions.

Note: If a user has permission to delete test cases, they will also be able to delete test executions when doing so. Please be aware of this when setting permissions.
The 'Permissions' screen

Click the image to enlarge it.

To make changes, click one of the editable fields for the action you want to change, add or remove users, roles, and/or groups for the action, then click Save. Finally, refresh the page to apply the changes.


Versions are snapshots of a project over time. You can compare version to version to see changes, which can help you schedule and organize your releases.

Zephyr Scale uses the versions specified on this project setting.

The 'Releases' screen

Click the image to enlarge it.


Components are subsections of a project used to group issues or test cases into smaller parts.

Zephyr Scale uses the components specified in this project setting.

The 'Components' screen

Click the image to enlarge it.

See Also

Configuring Zephyr Scale Server
Configure Jira Global Settings for Zephyr Scale

Highlight search results