Community Contribution criteria

To help ensure that the contents of the GOV.UK Design System are of a high quality and meet user needs, all components and patterns must meet the following criteria.

New proposals

To be considered for inclusion in the GOV.UK Design System, components and patterns must be:

Criteria Description
Useful It addresses a user need that’s shared by multiple services or products.
Unique It doesn’t duplicate something which already exists in the GOV.UK Design System, unless it’s intended to replace it.

The working group will review all proposals in the community backlog to check they meet these criteria, before they are agreed.

Before publication

Before new components and patterns are published into the GOV.UK Design System, the working group will review them again to make sure that they are:

Criteria Description
Usable

It has been tested in user research and shown to work with a representative sample of users, including those with disabilities.

Components and patterns which do not meet the ‘usable’ criteria can be published as ‘experimental’, provided that they are based on relevant user research from other organisations and best practice, and meet the other criteria.

Most new components and patterns will be published as experimental at first. The experimental tag can be removed once they have been validated through research in a range of services, and with different types of users.

Consistent

It uses existing styles and components in the GOV.UK Design System where relevant.

Any code follows the GOV.UK Frontend coding standards and is ready to merge in GOV.UK Frontend.

Versatile It can be easily applied in different contexts.
Tested It’s been tested and shown to work with a range of browsers, assistive technologies and devices.
Considered There are no obvious political, security or ethical implications.

Get in touch

If you’ve got a question, idea or suggestion share it in #govuk-design-system on cross-government Slack (open in app) or email the Design System team