Mattermost Logo
We're hiring!
Edit on GitHub

Using Labels to Track Issues and PRs at Mattermost

We leverage GitHub labels to track the details and lifecycle of issues and pull requests.

Issue Labels 

  • Area/<name>: Involves changes to the named area (APIv4, E2E Tests, Localization, Plugins, etc.)
  • Bug Report/Open: Bug report unresolved, awaiting for more information or in development backlog.
  • Bug Report/Scheduled for Release: Bug report resolved and scheduled for an upcoming release. Milestone indicates scheduled release version.
  • Difficulty/1:easy: Easy ticket.
  • Difficulty/2:medium: Medium ticket.
  • Difficulty/3:hard: Hard ticket.
  • Good First Issue: Suitable for first-time contributors.
  • Help Wanted: Community help wanted.
  • Move to Feature Ideas forum: Marked for relocation to the feature ideas forum.
  • Move to Troubleshooting: Marked for relocation to the troubleshooting section of the documentation.
  • PR Submitted: A pull request has been opened for this issue.
  • Tech/<name>: Requires using the named technology (Go, JavaScript, ReactJS, Redux, etc.)
  • Up for Grabs: Ready for help from the community. Removed when someone volunteers.

Pull Request Labels 

  • 1: PM Review: Requires review by a product manager.
  • 1: UX Review: Requires review by a UX designer.
  • 2: Dev Review: Requires review by a core committer.
  • 3: QA Review: Requires review by a QA tester. May occur at the same time as Dev Review.
  • 4: Reviews Complete: All reviewers have approved the pull request.
  • Awaiting Submitter Action: Blocked on the author.
  • AutoMerge: If all checks and approvals pass and the user adds this label, it will be in the queue to get merge automatically without a human intervention.
  • Changelog/Done: Required changelog entry has been written.
  • Changelog/Not Needed: Does not require a changelog entry.
  • CherryPick/Approved: Meant for the quality or patch release tracked in the milestone.
  • CherryPick/Candidate: A candidate for a quality or patch release, but not yet approved.
  • CherryPick/Done: Successfully cherry-picked to the quality or patch release tracked in the milestone.
  • Demo Plugin Changes/Needed: Requires changes to the demo plugin.
  • Demo Plugin Changes/Done: Required changes to the demo plugin have been submitted.
  • Do Not Merge/Awaiting Loadtest: Must be loadtested before it can be merged.
  • Do Not Merge/Awaiting Next Release: To be merged with the next release (e.g. API documentation updates).
  • Do Not Merge/Awaiting PR: Awaiting another pull request before merging (e.g. server changes).
  • Do Not Merge: Should not be merged until this label is removed.
  • Docs/Done: Required documentation has been written.
  • Docs/Needed: Requires documentation.
  • Docs/Not Needed: Does not require documentation.
  • Hackfest: Related to a Mattermost hackathon.
  • Hacktoberfest: Related to Hacktoberfest.
  • Lifecycle/<state>: An inactive contribution.
  • Loadtest: Triggers an automatic load test.
  • Major Change: The pull request is a major feature or affects large areas of the code base (e.g. moving channel store and actions to Redux).
  • Setup Test Server: Triggers the creation of a test server.
  • Setup Upgrade Test Server: Triggers the creation a test server and performs an upgrade.
  • Tests/Done: Required tests have been written.
  • Tests/Not Needed: Does not require tests.
  • Work in Progress: Not yet ready for review.