> ## Documentation Index
> Fetch the complete documentation index at: https://docs.flexagon.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Issue Tracking

> The Issue Tracking Systems page, which can be accessed through selecting the Issue Tracking tab on the Integrations page and clicking the Providers bu

The Issue Tracking Systems page, which can be accessed through selecting the ***Issue Tracking*** tab on the ***Integrations*** page and clicking the ***Providers*** button on the top right of the table, allows the management of integrations into the third-party issue tracking systems. FlexDeploy currently provides out-of-box integration with Atlassian Jira, Redmine, Azure Boards, GitLab, and GitHub. You can define a custom implementation using either Java class or Groovy script. FlexDeploy reads ticket(s) from SCM commit message comments during build execution. As an example, if you use SVN when committing a change back to the repository, simply put the issue name in the commit comment (case sensitive).  Some SCMs require clients installed on the FlexDeploy Server.

FlexDeploy comes with a Java Implementation to integrate with Jira, Redmine, or Azure Boards, and a Groovy implementation to integrate with GitLab or GitHub. You are not allowed to change the implementation class and change or add new properties for these out-of-box issue tracking systems. You can create an additional Issue Tracking Systems as necessary using the **Create** button. To edit custom Issue Tracking Systems or view out-of-box ones, select its name in the table.

![Image](https://mintcdn.com/flexagon-llc-ce77a95c/d70xZJSQ0kNavvGo/images/fd90/10926696446.png?fit=max\&auto=format\&n=d70xZJSQ0kNavvGo\&q=85\&s=5ae115263fd599e127895fda6233152a)

### Terminology

<table><colgroup><col /><col /></colgroup><tbody><tr><th>**FlexDeploy Term**</th><th>**Description**</th></tr><tr><td>Work Item</td><td>Work Items are used to track features, requirements, bugs, and risks to your project. Sometimes they are also known as Issues. Each work item is identified by a unique work item number.</td></tr><tr><td>Issue Tracking System</td><td>Defines the system used to track the tickets for specific projects or applications using patterns or custom rules. Various providers are available out-of-box, but you can add one or more custom systems using either Java or Groovy script implementation.</td></tr><tr><td>Issue Tracking System Instance</td><td>Instance represents the physical connection details of the Issue Tracking System.</td></tr><tr><td>Property</td><td>Properties are used to define the necessary inputs needed to connect to the system.</td></tr><tr><td>Status</td><td>Status is used to measure the progress of work done, as well as to represent the current stage of the issue.</td></tr></tbody></table>

Let's review each topic in detail now.

* The issue tracking integrations for out-of-the-box providers are not editable.

* For adding a custom issue tracking system, follow the steps described in [Custom Issue Tracking System](https://docs.flexagon.com/flexdeploy-9-0-documentation/flexdeploy-users-guide/integrations/issue-tracking/custom-issue-tracking-systems.md)

* Create an issue tracking system instance to integrate with FlexDeploy. [Configure Issue Tracking System Instance](https://docs.flexagon.com/flexdeploy-9-0-documentation/flexdeploy-users-guide/integrations/issue-tracking/configure-issue-tracking-system-instance.md) shows how to set up the instance by providing the server and credential information

* The next steps after creating and testing the instance is to [Configure Project for Issue Tracking.](https://docs.flexagon.com/flexdeploy-9-0-documentation/flexdeploy-users-guide/integrations/issue-tracking/configure-project-for-issue-tracking.md) Here you can choose any configured issue tracking system instance and define how you want to integrate with the system

* Tickets are associated when a project is built. [Associate Work Items to a Build](https://docs.flexagon.com/flexdeploy-9-0-documentation/flexdeploy-users-guide/integrations/issue-tracking/associate-work-items-to-a-build.md) describes how FlexDeploy processes the tickets

Here is the setup needed for out of the box issue tracking systems.

* [FlexDeploy Work Item Integration](https://docs.flexagon.com/flexdeploy-9-0-documentation/flexdeploy-users-guide/integrations/issue-tracking/out-of-the-box-issue-tracking-system-configuration/flexdeploy-work-item-integration.md)
* [JIRA Integration](https://docs.flexagon.com/flexdeploy-9-0-documentation/flexdeploy-users-guide/integrations/issue-tracking/out-of-the-box-issue-tracking-system-configuration/jira-integration.md)
* [Azure Boards Work Items Integration](https://docs.flexagon.com/flexdeploy-9-0-documentation/flexdeploy-users-guide/integrations/issue-tracking/out-of-the-box-issue-tracking-system-configuration/azure-boards-work-items-integration.md)
* [GitHub Issues Integration](https://docs.flexagon.com/flexdeploy-9-0-documentation/flexdeploy-users-guide/integrations/issue-tracking/out-of-the-box-issue-tracking-system-configuration/github-issues-integration.md)
* [GitLab Issues Integration](https://docs.flexagon.com/flexdeploy-9-0-documentation/flexdeploy-users-guide/integrations/issue-tracking/out-of-the-box-issue-tracking-system-configuration/gitlab-issues-integration.md)
* [Redmine Issues Integration](https://docs.flexagon.com/flexdeploy-9-0-documentation/flexdeploy-users-guide/integrations/issue-tracking/out-of-the-box-issue-tracking-system-configuration/redmine-issues-integration.md)