Skip to main content

Issues and PRs > Metatags

Tom Williams avatar
Written by Tom Williams
Updated over a week ago

Dataset: Issues & Pull Requests

Entity: Pull Requests, Issues

Field ID: metatags

Type: List of text values

Description: A list of keywords categorizing the type of work associated with the issue or pull request.

Source: Calculated

Transformation logic:

  • Issues: the combination of labels and sub_type.

  • Pull requests: the combination of labels from the pull request and metatags from resolved issues. Resolved issues are issues referenced by the pull request via auto-closing keywords.

From:

Github (PRs, Issues)

Inferred from self and resolved issues

Gitlab (PRs, Issues)

Inferred from self and resolved issues

Bitbucket (PRs)

Inferred from self and resolved issues

Azure DevOps (PRs, Issues)

Inferred from self and resolved issues

JIRA (Issues)

Calculated

ClickUp (Issues)

Calculated

Trello (Issues)

Calculated

Reporting Use Cases

The Metatags field is one of the most powerful attributes for accurately categorizing work, as it provides a comprehensive list of all relevant keywords associated with an item. For pull requests, its unique ability to inherit the labels and types from the issues it resolves makes it superior to Labels for almost any kind of categorization.

  • Accurate Work Categorization: This is the primary use case for metatags. Since it includes tags from resolved issues, you can accurately categorize a pull request based on the problem it solves, not just the labels on the PR itself.

    • Change Failure Rate (DORA Metric): You can build a highly accurate Change Failure Rate metric by identifying pull requests that fix bugs. A custom formula like COUNT_IF(CONTAINS(metatags, "Bug")) will correctly count a PR that resolves a Jira "Bug" issue, even if the PR itself is not labeled "Bug".

    • Work Type Analysis: Create a pie chart to see the breakdown of your engineering efforts. Use a dimension with a formula like IF(CONTAINS(metatags, "bug"), "Bug Fixes", "Feature Work") to correctly categorize all merged pull requests.

  • Filtering and Scoping: You can create powerful reports that link development activity back to your planning process.

    • Find all Bug-Fixing PRs: Create a report of all pull requests that address a bug by using a single filter: Metatags contains "bug". This is much more reliable than filtering on PR labels alone.

    • Track Work by Issue Type: Find all pull requests related to "Story" or "Task" issues from Jira with a filter like Metatags contains any of "Story,Task".

  • Reporting on Individual Tags: Just like with label_names, you can use the FLATTEN function to analyze the prevalence of each individual tag across all your work items.

    • To see a list of the most common tags (including inherited ones), create a report with FLATTEN(metatags) as the dimension and COUNT() as the metric.

Did this answer your question?