App page
Requirements and Test Management for Jira
Cloud Server/Data Center
Requirements and Test Management for Jira

Cloud

Server/Data Center

Documentation
FAQ
Release notes
Migration to Cloud
Last updated Apr 20, 2025

Onboarding in a company-managed project

This chapter provides information on how to configure RTM for the first time in a company-managed project.

Warning

Before you start, log in as a user with the Jira Project Administrators project permissions.

In company-managed projects, you can choose to configure Requirements and Test Management (RTM) app either with one click or step by step.

Configure with one click

This option allows you to configure the application using default settings, limiting time needed to configure the app.

Steps

  1. Read the information in the Configure with one click section.

  2. Turn the toggle on to add sample data to your project.

  3. To learn how the application works and how it will be configured, click here.

  4. Click Enable.

    Configure RTM with one click.
    Configure RTM with one click.

Result

RTM application is configured in your company-managed project.

Watch the full app walkthrough

Configure step by step

This option allows you to customize the application modules to suit your team’s needs. On the onboarding screen, select Configure step by step.

Steps

  1. Select issue types that will be your requirements.

  2. If your project doesn’t have such issue types, you can add them automatically or manually.

    Tip

    We recommend adding such issue types like: Business goal, Business requirements, UI requirements and Non-functional requirements. If you select the Add automatically option, we will add these issues for you.

  3. Click Next.

    Map issue types to Requirements.
    Map issue types to Requirements.
  4. Select issue types that will be your testing objects.

  5. If your project doesn’t have such issue types, you can add them automatically or manually.

    Tip

    We recommend adding such issue types like: Test Case, Test Plan and Test Executions. If you select the Add automatically option, we will add these issues for you.

  6. Click Next.

    Map issue types to Testing objects.
    Map issue types to Testing objects.
  7. Select the project and issue types where the defects will be stored.

  8. Click Add next project to map issue types to defects in more than one project.

  9. Click Next

Map issue types to Defects.
Map issue types to Defects.
  1. In the Fields configuration step, we check if your fields configuration is proper. If fields configuration is ready click Next.
Checking the correctness of fields.
Checking the correctness of fields.
Warning

Incompatible fields may occur during field configuration. These fields aren’t supported in the RTM. Click Manage fields to change them to optional.

  1. If you want to generate sample data for your project turn the toggle on.
  2. Click Enable.
Enable RTM in the project.
Enable RTM in the project.

Result

RTM application is configured in your company-managed project. You’ll be redirected to the main page of the application - the Dashboard. Now you’ll be able to create your requirements, test plans, test cases etc.

Watch the full configuration walkthrough

Need help?

If you can’t find the answer you need in our documentation, raise a support request. Include as much information as possible to help our support team resolve your issue faster.