Understanding Labels

Labels use namespaces to help with filtering and discovering issues, PRs and discussions. These namespaces correspond to logical objects of the application or sections, such as home, dashboard, explore, and others. Namespaces can also represent actions such as need:more-info.

Using Labels

Always search for existing labels. There are over 400 labels available and it's very probable that the label that you are looking for already exists.

Creating new labels should only be necessary if the existing labels do not provide enough context and if you foresee that the new label will be heavily used in the future. In any other case just use the namespace / catch-all labels, such as dashboard, viz:charts, explore, etc. You can find all the namespaces by searching for the word Namespace on the Labels Page.

Below are outlined some of the most relevant namespaces that are currently in use.

Priority namespaces

rush!

Requires immediate attention.

.pinned

To draw the attention of the community of committers.

P{number}

Refers to priority items, such as P0, P1, P2, etc.

Bug related

#bug

Some examples are #bug:blocking!, #bug:regression, #bug:cant-reproduce.

validation:{status}

It refers to the status of the issue, whether it was validated / submitted by a committer or reproduced by multiple users.

validation:required to require validation from a committer.

validation:validated when an issue was reproduced and must be fixed.

won't-fix

The issue won't be fixed.

Namespaces for objects and sections

api

Anything related to the REST API. Some examples are api:dashboards, api:charts.

data

Anything related to data, such as database configurations, datasets, etc. Some examples are data:connect:vertica, data:connect:presto, data:databases, data:datasets.

alerts-reports

Anything related to the Alerts & Reports feature.

dashboard

Anything related to dashboards, some examples include dashboard:cross-filters, dashboard:native-filters, dashboard:performance, dashboard:design and others.

explore

Anything related to Explore. Some examples include explore:datapanel, explore:design, explore:metrics, explore:performance.

viz

Anything related to viz types. Some examples include viz:charts:line, viz:charts:table, viz:dynamic-plugins.

home

Anything related to the Homepage. Some examples are home:design, home:favorite, home:recent.

listview

Anything related to lists of objects, such as Dashboards, Datasets, Charts, etc, such as listview:dashboards.

global

A generic namespace for features that fit globally in Superset. Some examples include global:error, global:omnibar, global:async-query.

Namespaces for actions and assignments

need:{action}

Issues or discussions that require action. Some examples include need:design-review, need:more-info, need:community-volunteer.

hold!

Mostly used for PRs that need to hold, for example, hold:testing!

assigned:{team}

Mostly used for issues that are assigned to specific teams, such as assigned:preset, assigned:airbnb.

Other namespaces

i18n

Anything related to translations and localization in general. Some examples include i18n:italian, i18n:chinese, i18n:french.

doc

Anything related to the documentation, such as doc:user, doc:developer.

infra

Anything related to infrastructure, including infra:webserver, infra:caching.

install

Anything related to the installation. Some examples are install:docker, install:config.