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.

Https

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.

Latest release: Component Library: v53.1.0 released on Sep 29, 2025 | Guidance: Sprint 12 released on Sep 29, 2025 | Figma: Changelog

About

What's new?

The latest news and updates on the VA Design System.

Guidance Updates

Sprint 12
September 29, 2025

What’s Changed

Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-11…Sprint-12

Sprint 11
September 17, 2025

What’s Changed

New Contributors

Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-10…Sprint-11

Sprint 10
September 4, 2025

What’s Changed

Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-9…Sprint-10

VADS Component Library Releases

v53.1.0
September 29, 2025

What’s Changed

New Features & Components 🎉

  • va-accordion: create separate buttons for “expand all” and “collapse all” by @amyleadem in #1772
  • va-memorable-date: add labelHeaderLevel prop by @powellkerry in #1775
  • va-text-input: add the vaInput custom event by @jamigibbs in #1798
  • va-text-input: add password type variation by @RyanMunsch in #1787
  • va-file-input: use new password variation to mask file password by @RyanMunsch in #1787

Fixes

  • va-table: add interactive elements to a cell by @ediiotero in #1752
  • va-button-segmented: update details payload for analytics event by @RyanMunsch in #1779
  • va-file-input: replace <hr/> element with a border on parent by @RyanMunsch in #1792

Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v53.0.0…v53.1.0

v53.0.0
September 15, 2025

What’s Changed

Breaking Changes

  • va-date, va-memorable-date, va-telephone-input, va-text-input: Update onblur validation by @powellkerry in #1760

New Features & Components 🎉

  • va-on-this-page: Convert title list item to a header element by @amyleadem in #1759
  • va-memorable-date: Add prop to remove the default date hint by @jamigibbs in #1763

Fixes

  • va-button-segmented: Update styles for two/three buttons by @RyanMunsch in #1762
  • va-textarea: Fix horizontal overflow at high zoom by @amyleadem in #1768
  • va-memorable-date: Add watch decorator to the value prop by @jamigibbs in #1770
  • va-modal: Fix focus trap bug (and clean up component file) by @RyanMunsch in #1773

Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v52.1.1…v53.0.0

v52.1.1
September 2, 2025

What’s Changed

Fixes

  • va-omb-info: remove “View” from privacy act statement button by @amyleadem in #1740
  • va-telephone-input: improve error message accuracy by @powellkerry in #1726
  • va-accordion-item: update headline slot approach to resolve unescaped HTML entities by @RyanMunsch in #1741
  • va-telephone-input: correct width/media query breakpoint by @RyanMunsch in #1744
  • va-additional-info, va-alert-expandable, va-memorable-date: adjust slot styles by @powellkerry in #1746
  • va-radio and va-telephone-input: improve consistency of the error message screen reader announcement by @amyleadem in #1724
  • va-date: add spacing when fields wrap by @powellkerry in #1747
  • va-file-input: only show password field and additional info slot if progress bar not visible by @powellkerry in #1749

Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v52.1.0…v52.1.1

Figma Component Library Changelog

Content Style Guide Updates

August 2025

Dates, times, phone numbers, and addresses

Added an exception to time zone formatting for automated time stamps:

For automated time stamps from the time library used in vets-website (date-fns), the time zone uses the 3-letter format (ex. EDT).

  • Revised guidance on inline/embedded links:

    In general, put a link on a separate line to help it stand out. Have a case where you think an inline link might be necessary due to space limitations? Contact the centralized content team for help with your content.

  • Fixed broken link to the Links component page.

Numbers, signs, and symbols

  • Changed the page title to Numbers, signs, and symbols
  • Added the ampersand information (moved from the Punctuation page; no changes to the guidance)
  • Clarified that there are no spaces around degree symbols or percent signs
  • Revised the guidance on using “1” versus “one” to only use “one” with certain expressions:

    Spell out “one” when it’s used in expressions like one-to-one, one-on-one, one-time, and “one of the reasons…” Use the numeral “1” for all other instances.

  • Made edits to the rest of the page to align with our style (these edits don’t affect guidance)

Punctuation

  • Removed the information on ampersands (moved this to the Numbers, signs, and symbols page)
  • Added an exception for using quotes when referring to buttons, section titles, etc. if the text is already bold:

    Note: If the text is already bold (like in some error messages), we can use quotation marks to reference buttons, screens, or section headers.

  • Made edits to the rest of the page to align with our style (these edits don’t affect guidance)
Edit this page in GitHub (Permissions required)
Last updated: Oct 15, 2025