---
title: "Project Organization"
canonical: "https://docs.getxray.app/space/XRAYCLOUD/44566397/Project%20Organization"
format: markdown
---
<span style="color: #000000">Because Xray uses issue types for mapping test concepts, you can organize your projects to best suit your organizational needs. You can keep your current projects separate from Xray, or combine them together. </span>

<span style="color: #000000">Xray is flexible enough to deal with scenarios where, for security or compliance reasons, you have to manage Jira entities on different projects.</span>

> Macro (toc)

<span style="color: #000000"> </span>

# Project Organization Use Cases

<span style="color: #000000">Below are some common use cases showing how to use Xray in combination with other projects in Jira. Xray issue types support associations from different projects. You can add Tests from one project to Tests Executions on another project, or even mix Tests from different Projects in the same Test Execution or Test Set issue.</span>

## <span style="color: #000000">All-in-one </span>

<span style="color: #000000">You can use a single project to manage your Requirements and Defects, Test-related issues as well as all your Test Executions.</span>


> ℹ️ **Recommendation**
> ℹ️ 
> ℹ️ This is the preferred organization approach as it provides some key benefits over other alternatives:
> ℹ️ 
> ℹ️ - **Self-contained**
> ℹ️ - Easy to understand and manage
> ℹ️ - Promotes team collaboration


> Macro (gliffy)

### <span style="color: #000000">How to set it up</span>

1. <span style="color: #000000">Create a new Scrum project or use an existing one.</span>
2. <span style="color: #000000">Add Test, Precondition, Test Set, Test Plan, Test Execution and Sub-Test Execution issue types to the project. This can easily be done using a shortcut available in the </span><span style="color: #000000">**Summary**</span><span style="color: #000000"> section within the project settings (see  </span><span style="color: #000000">[Project Settings: Summary](https://getxraydocs.atlassian.net/wiki/pages/createpage.action?spaceKey=xraycloud&title=Project%20Settings%3A%20Summary&linkCreation=true&fromPageId=44566397)</span><span style="color: #000000">) for editing the Issue Type Scheme used by the project. You can also be do it from within Jira administration > Settings > Issues > Issue Type Schemes.</span>
3. <span style="color: #000000"> In the project settings, withi</span>n the **Test Coverage** section (see [Project Settings: Test Coverage](https://getxraydocs.atlassian.net/wiki/pages/createpage.action?spaceKey=xraycloud&title=Project%20Settings%3A%20Test%20Coverage&linkCreation=true&fromPageId=44566397)), define the Covered Issue Types (i.e., the testable entities such as the typical requirements, user stories, epics). On the left side, you can see all available Issue Types. Drag the ones you want (e.g., Story, Epic) to the **Covered Issue Types** and save the settings.

## <span style="color: #000000">Separate my Requirements and Defects from Tests</span>

<span style="color: #000000">If you already have a Jira project for managing Requirements and Defects and don't want to have any tests nor executions in this project, you can create a separate companion project just for testing purposes. </span>


> Macro (gliffy)

### <span style="color: #000000">How to set it up</span>

1. Create a Scrum project or use an existing one for managing the "Requirements Project".
2. Create another project (it can also be a Scrum project) for managing the "Test Project".
3. <span style="color: #000000">In the "Test Project", add Test, Precondition, Test Set, Test Plan, Test Execution and Sub-Test Execution issue types to the project. Remove all other issue types. This can easily be done using a shortcut available in the </span><span style="color: #000000">**Summary**</span><span style="color: #000000"> section within the project settings (see  </span><span style="color: #000000">[Project Settings: Summary](https://getxraydocs.atlassian.net/wiki/pages/createpage.action?spaceKey=xraycloud&title=Project%20Settings%3A%20Summary&linkCreation=true&fromPageId=44566397)</span><span style="color: #000000">) for editing the Issue Type Scheme used by the project. You can also be do it from within Jira administration > Settings > Issues > Issue Type Schemes.</span>
4. <span style="color: #000000">In the "Requirement Project" project settings, withi</span>n the **Test Coverage** section (see [Project Settings: Test Coverage](https://getxraydocs.atlassian.net/wiki/pages/createpage.action?spaceKey=xraycloud&title=Project%20Settings%3A%20Test%20Coverage&linkCreation=true&fromPageId=44566397)), define the Covered Issue Types (i.e. the testable entities such as the typical requirements, user stories, epics). <span style="color: #333333">On the left side, you can see all available Issue Types. Drag the ones you want (e.g., Story, Epic) to the </span>**Covered Issue Types**<span style="color: #333333"> and save the settings.</span>

## <span style="color: #000000">Dedicated repository for Tests</span>

<span style="color: #000000">Another common use case for Xray is to have a dedicated project for Test (and Precondition and Test Set) issues. Test Executions are the responsibility of other project(s). This separation allows you to manage permissions more effectively; maybe only a few testers have permission to write tests while others only have permission to execute.</span>

<span style="color: #000000">Of course, this use case can also be combined with the previous one by having separate projects for managing Requirements and Defects.</span>

> Macro (gliffy)

> ✅ **Test Execution Versioning**
> ✅ 
> ✅ If you plan to have separate projects for managing Requirements/Defects and Tests Executions and you want to analyze Requirements by version, then your Requirement's project version names must match the names of the Test Execution's project.

###   
<span style="color: #000000">How to set it up</span>

1. Create a Scrum project or use an existing one for managing the "Requirements Project".
2. Create another project (it can also be a Scrum project) for managing the "Test Project"
3. Create another project (it can also be a Scrum project) for managing the "Test Executions Project".
4. <span style="color: #000000">In the "Test Project", add Test, Precondition and Test Set issue types to the project. Remove all other issue types. This can easily be done using a shortcut available in the </span><span style="color: #000000">**Summary**</span><span style="color: #000000"> section within the project settings (see  </span><span style="color: #000000">[Project Settings: Summary](https://getxraydocs.atlassian.net/wiki/pages/createpage.action?spaceKey=xraycloud&title=Project%20Settings%3A%20Summary&linkCreation=true&fromPageId=44566397)</span><span style="color: #000000">) for editing the Issue Type Scheme used by the project. You can also be do it from within Jira administration > Settings > Issues > Issue Type Schemes.</span><span style="color: #333333"> </span>
5. <span style="color: #000000">In the "Test Executions Project", add Test Plan, Bug and Test Execution issue types to the project. Remove all other issue types.</span>
6. <span style="color: #000000">In the "Requirement Project", add the Sub-Test Execution issue type.</span>
7. <span style="color: #000000">In the "Requirement Project" project settings, withi</span>n the **Test Coverage** section (see [Project Settings: Test Coverage](https://getxraydocs.atlassian.net/wiki/pages/createpage.action?spaceKey=xraycloud&title=Project%20Settings%3A%20Test%20Coverage&linkCreation=true&fromPageId=44566397)), define the Covered Issue Types (i.e., the testable entities such as the typical requirements, user stories, epics). <span style="color: #333333">On the left side, you can see all available Issue Types. Drag the ones you want (e.g., Story, Epic) to the </span>**Covered Issue Types**<span style="color: #333333"> and save the settings.</span>

## Completely separate

<span style="color: #000000">In this use case, the Tests, Requirements, Executions & Plans and Defects separated and handled in different projects.</span>

> Macro (gliffy)

### <span style="color: #000000">How to set it up</span>

1. Create a Scrum project or use an existing one for managing the "Requirements Project".
2. Create another project (it can also be a Scrum project) for managing the "Test Project".
3. Create another project (it can also be a Scrum project) for managing the "Test Executions Project"
4. Create another project (it can also be a Scrum project), for managing the "Defects Project".
5. <span style="color: #000000">In the "Test Project", add Test, Precondition and Test Set issue types to the project. Remove all other issue types. This can easily be done using a shortcut available in the </span><span style="color: #000000">**Summary**</span><span style="color: #000000"> section within the project settings (see  </span><span style="color: #000000">[Project Settings: Summary](https://getxraydocs.atlassian.net/wiki/pages/createpage.action?spaceKey=xraycloud&title=Project%20Settings%3A%20Summary&linkCreation=true&fromPageId=44566397)</span><span style="color: #000000">) for editing the Issue Type Scheme used by the project. You can also be do it from within Jira administration > Settings > Issues > Issue Type Schemes.</span>
6. <span style="color: #000000">In the "Test Executions Project", add Test Plan and Test Execution issue types to the project. Remove all other issue types.</span>
7. <span style="color: #000000">In the "Requirement Project", add the Sub-Test Execution issue type.</span>
8. <span style="color: #000000">In the "Defects Project", add the Bug issue type.</span>
9. <span style="color: #000000">In the "Test Executions Project", add Test Plan and Test Execution issue types to the project. Remove all other issue types.</span>
10. <span style="color: #000000">In the "Requirement Project" project settings, withi</span><span style="color: #333333">n the </span><span style="color: #000000">**Test Coverage**</span><span style="color: #333333"> section (see </span><span style="color: #000000">[Project Settings: Test Coverage](https://getxraydocs.atlassian.net/wiki/pages/createpage.action?spaceKey=xraycloud&title=Project%20Settings%3A%20Test%20Coverage&linkCreation=true&fromPageId=44566397)</span><span style="color: #333333">), define the Covered Issue Types (i.e., the testable entities such as the typical requirements, user stories, epics). On the left side, you can see all available Issue Types. Drag the ones you want (e.g., Story, Epic) to the </span><span style="color: #000000">**Covered Issue Types**</span><span style="color: #333333"> and save the settings.</span>


## Isolated repository for Tests

In this more uncommon scenario, you have your requirements outside of Jira in some other tool. You use Jira only as a testing repository for creating Tests, Test Sets, Test Plans and Test Executions.

You certainly can use Xray for this, but you will lose the benefits of requirement coverage and traceability.

> Macro (gliffy)

> ℹ️ Users implementing this scenario might gain huge benefits if they are able to synchronize the requirements in the other tool and Jira.

### <span style="color: #000000">How to set it up</span>

1. Create a Scrum project or use an existing one for managing the "Test Project". This one will be handled like a Requirements Project;
2. <span style="color: #000000">In the "Test Project", add Test, Precondition and Test Set issue types to the project. Remove all other issue types, except the issue type to be handled as a requirement and the Bug. This can easily be done using a shortcut available in the </span><span style="color: #000000">**Summary**</span><span style="color: #000000"> section within the project settings (see  </span><span style="color: #000000">[Project Settings: Summary](https://getxraydocs.atlassian.net/wiki/pages/createpage.action?spaceKey=xraycloud&title=Project%20Settings%3A%20Summary&linkCreation=true&fromPageId=44566397)</span><span style="color: #000000">) for editing the Issue Type Scheme used by the project. You can also be do it from within Jira administration > Settings > Issues > Issue Type Schemes.</span>
3. <span style="color: #000000">In the "Test Project" project settings, withi</span><span style="color: #333333">n the </span><span style="color: #000000">**Test Coverage**</span><span style="color: #333333"> section (see </span><span style="color: #000000">[Project Settings: Test Coverage](https://getxraydocs.atlassian.net/wiki/pages/createpage.action?spaceKey=xraycloud&title=Project%20Settings%3A%20Test%20Coverage&linkCreation=true&fromPageId=44566397)</span><span style="color: #333333">), define the Covered Issue Types (i.e., the testable entities such as the typical requirements, user stories, epics). On the left side, you can see all available Issue Types. Drag the ones you want (e.g., Story, Epic) to the </span><span style="color: #000000">**Covered Issue Types**</span><span style="color: #333333"> and save the settings.</span>