TestOps logo
Try TestOps

YouTrack

YouTrack integration connects Allure TestOps artifacts to YouTrack issues. It covers:

  • searching and linking YouTrack issues from Allure TestOps;
  • authenticating an Allure TestOps project against YouTrack with either a token or a password;
  • configuring issue mapping so Allure TestOps can turn test metadata into YouTrack links automatically.

Both YouTrack Cloud and self-hosted YouTrack are supported through the same integration path.

Before you begin

  • The URL of the YouTrack instance.
  • Either a YouTrack token or a YouTrack username and password.
  • The issue-mapping key you want your tests to emit if you use automatic linking.
  • Permission to add global integrations in Allure TestOps and to enable them in the target project.

For manual issue linking from a test case, the YouTrack instance must be reachable from the Allure TestOps instance.

1. Create a YouTrack token

Skip this step if you prefer to use a username and password.

  1. In YouTrack, click your avatar and go to Profile.
  2. Open the Account Security tab.
  3. Under Tokens, click New token.
  4. Fill in the fields:
    • Token Name — a name to identify the token, for example Token for Allure TestOps.
    • Scope — select YouTrack.
  5. Click Create, then click Copy token. Save it in a secure location.

2. Add the YouTrack integration globally in Allure TestOps instance

  1. Open Administration → Integrations in Allure TestOps.
  2. Click + Add integration.
  3. Select YouTrack.
  4. Fill in the fields:
    • Name — a stable name for the integration, for example instancename.youtrack.cloud.
    • Endpoint — the URL of the YouTrack instance, for example https://instancename.youtrack.cloud.
  5. If the YouTrack instance uses a self-signed certificate, check Disable certificate validation.
  6. Click Add integration.

3. Enable the YouTrack integration on a project level

For the integration created in the step #2, do the following.

  1. On the integration's Configuration page, select Basic under Default Secret.
  2. Enter the YouTrack username in the Username field.
  3. Enter the YouTrack password in the Password field.
  4. Click Test connection. If the connection is successful, click Save changes.
  1. In Allure TestOps, open the target project.
  2. Go to Settings → Integrations.
  3. Under Available integrations, find YouTrack integration created in the step #2, and click Add integration.
  4. Enter the credentials:
    1. YouTrack username and password.
    2. Or YouTrack permanent token created in the step #1.
  5. Click Test connection. If the connection is successful, click Save changes.

If your tests already emit issue labels through an Allure adapter, create an issue mapping so Allure TestOps can convert those labels into real YouTrack links.

  1. In Allure TestOps, open the target project.

  2. Go to Settings → Issues.

  3. Click + Create.

  4. Fill in the fields:

    • Key — the short mapping key your tests emit, for example youtrack-prod.
    • Issue tracker — the YouTrack integration you enabled for the project.

  5. Click Submit.

Example test metadata using the mapping key:

import { test } from "@playwright/test";
import { allure } from "allure-playwright";

test("Some test", async ({ page }) => {
  allure.label("youtrack-prod", "BUG-123");
  // ...
});

Here youtrack-prod is the issue-mapping key and BUG-123 is the YouTrack issue ID that Allure TestOps should link.

In a real test suite, wrap the label call in your own helper so the mapping key is defined in one place instead of being duplicated across the codebase. See the Allure Report documentation for your test framework.

Verify the integration

  1. Open a test case or launch in Allure TestOps and add a YouTrack issue link.
  2. Confirm that the picker can search the expected YouTrack issues.
  3. If your tests emit issue metadata, upload a run that contains the mapping key and confirm that Allure TestOps creates the YouTrack links automatically.

YouTrack issue links in an Allure TestOps test result

Troubleshooting

The issue picker is empty

Check these points:

  • The YouTrack project integration is enabled and uses valid credentials.
  • The YouTrack instance is reachable from the Allure TestOps instance.
  • The user behind the token or password can read the target YouTrack project.

The mapping key in Settings → Issues does not match the key emitted by the tests, or the test metadata uses a different issue ID format than the target YouTrack project expects.

© Qameta Software Inc. All rights reserved.