Skip to content

Squash TM (FREE SELF)

Introduced in GitLab 15.10.

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.

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. On the left sidebar, 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.