Skip to main content
U.S. flag

An official website of the United States government

Dot gov

The .gov means it’s official.
Federal government websites often end in .gov or .mil. Before sharing sensitive information, make sure you’re on a federal government site.


The site is secure.
The https:// ensures that you are connecting to the official website and that any information you provide is encrypted and transmitted securely.


Suggest a removal

Follow the steps below to suggest a component or pattern be deprecated in the design system

Like any site on the web, we can expect’s design to evolve. Some components might be updated and improved, while we might remove others entirely in favor of a replacement.

Deprecating a component is done only by the Design System Team. However, you can file an issue requesting that a component or pattern be deprecated. Be sure to include the following in your request:

  • Justification for removing the component or pattern
  • A recommendation on a replacement

You may need to come to the Design System Council with your request for discussion.

Suggest a removal

How the Design System Team deprecates a component

When we decide to remove a component, we take the following steps:


  • On the component’s guidance page in mark the component as deprecated.
  • Update the component-library version number to the next MINOR version.
  • Add a note on the “What’s new?” page indicating that the component is deprecated under the heading of the component-library version number mentioned above.
  • Archive the component in the Figma component and example libraries.


After a 30 day period the component can be removed entirely. To remove the component:

  • Delete the web-component.
  • Since this is a breaking change, update the component-library to the next MAJOR version
  • Remove the guidance page from
  • Add a note on the “What’s new?” page about the removal under the heading of the version number mentioned above
Edit this page in GitHub (Permissions required)
Last updated: Feb 20, 2024