Squash TM

{{< details >}}

• Tier: Free, Premium, Ultimate
• Offering: GitLab Self-Managed, GitLab Dedicated

{{< /details >}}

{{< history >}}

• Introduced in GitLab 15.10.

{{< /history >}}

When Squash TM (Test Management) integration is enabled and configured in GitLab, issues (typically user stories) created in GitLab are synchronized as requirements in Squash TM and test progress is reported in GitLab issues.

<i class="fa-youtube-play" aria-hidden="true"></i> For an overview of optimizing your DevSecOps workflow with the Squash TM and GitLab integration, see Leverage Requirements and Test management in your SDLC.

<!-- Video published on 2024-05-15 -->

Configure Squash TM

1. Optional. Ask your system administrator to configure a token in the properties file.
2. Follow the Squash TM documentation to:

   1. Create a GitLab server.

   2. Enable the Xsquash4GitLab plugin

   3. Configure a synchronization.

   4. From the Real-time synchronization panel, copy the following fields to use later in GitLab:

      • Webhook URL.
      • Secret token if your Squash TM system administrator configured one at step 1.

Configure GitLab

1. In the top bar, select Search or go to and find your project.

2. Select Settings > Integrations.

3. Select Squash TM.

4. Ensure that the Active toggle is enabled.

5. In the Trigger section, indicate which type of issue is concerned by the real-time synchronization.

6. Complete the fields:

   • Enter the Squash TM webhook URL,
   • Enter the secret token if your Squash TM system administrator configured it earlier.