Labels
The label sets in Title Case, each with a description and a colour distinct within any repository.
Labels are Title Case. Families use Group: Value. Every label has a one-line description in the same voice: types say what the change does, areas say “Related to …”, statuses say what they wait on. Every colour in a repository is distinct, checked in OKLab, and families share a hue band. Brand labels (operating systems, languages, services) use the brand’s colour, and other labels move to keep clear of them.
The label job renames a label listed under Renames rather than deleting it, so issues keep their labels. It never removes a label it doesn’t know without asking.
| Label | Description | Renames |
|---|
| Bug | Something isn't working as it should | |
| Bug Fix | Fixes a bug | bugfix |
| Feature | Adds a new feature or option | new-feature |
| Enhancement | Improves an existing feature | |
| Refactor | Restructures code without changing behaviour | |
| Performance | Improves performance without adding features | |
| Breaking Change | Changes behaviour existing users rely on | breaking-change |
| Security | A security issue that needs fixing as soon as possible | |
| Documentation | Related to the docs site, README or other documentation | |
| Tests | Related to tests | |
| CI | Related to GitHub workflows and continuous integration | |
| Maintenance | General upkeep and housekeeping | |
| Dependencies | Upgrades or downgrades dependencies | |
| Agents | Changes to agent instructions, skills and related configuration | |
| Accessibility | Affects people using assistive technology, keyboards or high contrast | |
| Label | Description | Renames |
|---|
| Planned | Accepted and planned to be implemented | |
| Ready | Unblocked and ready to start | |
| In Progress | Someone is working on this | in-progress |
| Needs Decision | Waiting on a decision before work can start | |
| Needs Research | Needs looking into before it can be planned | needs-research, Needs Investigation, investigation |
| Blocked | Blocked by something else and can't continue | |
| On Hold | Paused until something else is done or decided | |
| Future | Wanted, but for a later round | |
| Label | Description | Renames |
|---|
| Duplicate | This issue or pull request already exists | |
| Invalid | Not valid or not applicable to this project | |
| Won't Fix | This will not be worked on | wontfix |
| Label | Description | Renames |
|---|
| Needs More Information | More information is needed before this can continue | incomplete |
| Waiting for Reply | Waiting for the author to reply | waiting-for-response |
| Unable to Reproduce | Can't be reproduced, may be down to configuration or the system | unable-to-reproduce |
| Upstream Issue | Caused by a dependency or the operating system, not this project | |
| Feature Request | An idea to weigh, or a discussion where Discussions are on | |
| Good First Issue | Suitable for first-time contributors | beginner-friendly |
| Help Wanted | Extra hands or expertise are needed to resolve this | help-wanted |
| Stale | No activity for some time, marked by the stale bot | |
| No Stale | The stale bot won't mark or close this | no-stale |
| Version: Major | Needs a major version bump | major |
| Version: Minor | Needs a minor version bump | minor |
| Label | Description | Renames |
|---|
| Upstream Issue | Caused by a dependency or the operating system, not this project | |
| Needs More Information | More information is needed before this can continue | incomplete |
A repository lists these in its own file.
One per ecosystem the repository uses, for Renovate’s pull requests.
| Label | Description | Renames |
|---|
| GitHub Actions | Updates GitHub Actions | github_actions |
| Go | Updates Go code or modules | |
| JavaScript | Updates JavaScript or TypeScript code or packages | |
| Python | Updates Python code or packages | |
| Label | Description | Renames |
|---|
| Priority: Critical | Needs fixing as soon as possible | priority-critical |
| Priority: High | Next to be dealt with after critical issues | priority-high |
| Priority: Medium | Useful and needs some attention | priority-medium |
| Priority: Low | Nice to have, maybe someday | priority-low |
| Label | Description | Renames |
|---|
| OS: Linux | Specific to Linux | |
| OS: Windows | Specific to Windows | |
| OS: macOS | Specific to macOS | |
| OS: Android | Specific to Android | |
| OS: iOS | Specific to iOS and iPadOS | |
| Label | Description | Renames |
|---|
| Tests: Unit | Related to unit tests | |
| Tests: E2E | Related to end-to-end tests | |
Each repository can add labels for its own parts, described as “Related to …”. They’re on Repositories.
