Skip to content

Labeling Automation

Evan Rusackas edited this page Nov 19, 2026 · 4 revisions

Some of the labels on Apache Superset pull requests and issues are applied automatically. The settings for that automation live on wiki pages, so committers can update them without opening a pull request, and every change is kept in the page history.

Pages that drive labels

Page What it controls Workflow
Label Rosters Labels applied to PRs and issues based on who opened them, for example utsc2026 for students in the UTSC 2026 course author-labeler.yml
Audit Hold Paths hold:audit-* labels applied to PRs that change sensitive paths (CI workflows, CI scripts, .asf.yaml, maps, the extensions API, default config). These block merging until a reviewer removes them. wiki-labeler.yml
Path Labels Informational labels applied to PRs by the files they change: risk:*, dependencies:*, i18n:*, doc, api and the sub-project labels. These do not block merging. wiki-labeler.yml

Good to know

  • CI reads these pages as written. Each page starts with its own editing rules, so read those before changing anything.
  • Any section on these pages can list people under a Reviewers: line. CI requests a review from them on PRs that get that section's label, once the PR is out of draft. This is how the project routes reviews by path or by contributor group without a CODEOWNERS file.
  • Changes take effect within a few minutes of saving.
  • Every wiki edit is checked by the lint workflow, using the same parser as the labeler. If a page has an entry CI cannot use, the run fails and GitHub emails the person who made the edit. Results are listed under Actions.
  • Each page is limited in which labels it can assign, as its own editing notes explain. The limits are set in wiki-labels.js and exist because some labels trigger other automation: anything containing hold blocks merging, for example.
  • A label that does not exist in the repository yet is created the first time it is applied, plain grey with no description. Set its color and description on the labels page.
  • For what the labels themselves mean, see Understanding Labels.

Clone this wiki locally