Get involvedContribution criteria

The Home Office follows the GOV.UK Design System contribution criteria. The only difference is that contributions will be reviewed by the Home Office’s Design System Working Group.

The contents of the Design System must be of a high quality and meet user needs. To guarantee this, all components and patterns need to meet certain criteria.

New proposals

To be successful, proposals need to show that the component or pattern being suggested would be useful and unique.

New proposals criteria
Criteria Description

There is evidence that this component or pattern would be useful for many teams or services working on internal facing systems.

Evidence could be screenshots or links to versions of it being used in different services.


It does not replicate something already in the Design System.

If it’s intended to replace an existing component or pattern, there is evidence to show that it’s better than the existing version.

The Design System Working Group reviews proposals in the community backlog to check they meet these criteria. Proposals that meet the criteria will then be marked ‘to do’, ready to be worked on.

Before a component or pattern is published

Before publication criteria
Criteria Description

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 are not proven usable can be published as experimental. But they must be clearly based on relevant user research from other organisations and best practice, and meet the other criteria.


It reuses existing styles and components in the Design System where relevant.

Both the guidance and any content included in examples must follow the GOV.UK content style guide.


The implementation is versatile enough that the component or pattern can be used in a range of different services that may need it.

For example, a versatile date input component could be set up to ask for a year only, a month and year only, a precise date, or any other combination you may need.

The component or pattern must also have been tested and shown to work with a range of browsers, assistive technologies and devices.