Labels

Designing and using labels to help keep everything organized


Colors should be meaningful

Don’t create an “angry fruit salad” of labels in random, meaningless colors.

You’ll note that every issue, as part of triaging the intake stream, is assigned one of each color of label in the Project. This is deliberate and very important.

Each color corresponds to a category or type so you can immediately see when information is missing or duplicated.

But color isn’t everything

For accessibility purposes, add icons or emojis to labels so they’re not differentiated only by color.

The W3C Success Criterion mandates that “color is not used as the only visual means of conveying information, indicating an action, prompting a response, or distinguishing a visual element.”

Add labels that you need

You can add any other type of label you need. For example:

Labels can also serve as triggers for Actions.

But not everything needs a label

Many items such as assignees, reviewers, milestones, status, etc. are all tracked elsewhere already and don’t necessarily need explicit labels. Dates and deadlines, for example, can be much easier to see in the Roadmap view of a Project. Issues can be grouped into Milestones instead of applying a group Label.


  1. We track the source so that we can absolutely determine where an article’s content came from. Was it part of a release, or part of a larger document, or did someone contribute it out of tribal knowledge?