About
What's new?
What’s Changed
- chore: update releases for Sprint 3 by @Amy-Leadem in #6611
- Links: Simplify link opening behavior documentation by @Barbara-Denney in #6513
- va-button: Adds custom behavior guidance by @Jeana-Clark in #6614
- 📊 Update metrics dashboard data - 2026-07-03 by @Amy-Leadem in #6579
- Chore(deps): Bump the va-design-system-libraries group across 1 directory with 2 updates by @dependabot[bot] in #6629
- 📊 Update pattern adherence data - 2026-07-06 by @Amy-Leadem in #6580
- Add platform-design-system-team label to workflows by @Tricia-Baker in #6577
- 📊 Update metrics dashboard data - 2026-07-10 by @Amy-Leadem in #6606
- 📊 Update pattern adherence data - 2026-07-13 by @Amy-Leadem in #6610
- Adds alert to additional info pointing to va-details by @Jeana-Clark in #6633
- [Documentation] Fixes broken link by @Jeana-Clark in #6634
- Design Tokens - Updates design token docs by @Jeana-Clark in #6618
- Update token note. Don’t use vads-font-size-source-sans-normalized. by @JAMI-GIBBS in #6645
- Chore(deps): Bump brace-expansion from 1.1.13 to 1.1.16 by @dependabot[bot] in #6652
- Chore(deps): Bump @department-of-veterans-affairs/component-library from 56.8.0 to 56.9.0 in the va-design-system-libraries group by @dependabot[bot] in #6661
- Form watch PoC: OMB expiration poller + vets-api PDF template audit by @Dominic-Padula in #6647
- Form watch: Adds PDF revision watch and reorganizes Slack digests by @Dominic-Padula in #6666
- Token docs cleanup by @DANIEL-BRADY in #6663
- 📊 Update metrics dashboard data - 2026-07-17 by @Amy-Leadem in #6639
- 📊 Update pattern adherence data - 2026-07-20 by @Amy-Leadem in #6644
- file-input: adds ADR for field label by @Kerry-Powell in #6662
- Chore(deps): Bump json from 2.19.2 to 2.19.9 in the bundler group across 1 directory by @dependabot[bot] in #6693
- Chore(deps-dev): Bump tar from 7.5.16 to 7.5.21 by @dependabot[bot] in #6695
- Design token migration: metrics + page by @Robert-Hasselle in #6646
- 📊 Update metrics dashboard data - 2026-07-24 by @Amy-Leadem in #6696
- Updates EDR template, adds YML version by @Jeana-Clark in #6699
- Updates for Token migration page: include platform code, fix URL by @Robert-Hasselle in #6723
- Add owners to the design token migration page by @Robert-Hasselle in #6728
- Chore(deps): Bump brace-expansion from 1.1.16 to 1.1.18 by @dependabot[bot] in #6737
- 📊 Update metrics dashboard data - 2026-08-03 by @Amy-Leadem in #6735
New Contributors
- @Robert-Hasselle made their first contribution in #6646
Full Changelog: https://va.ghe.com/software/vets-design-system-documentation/compare/Sprint-3…Sprint-4
What’s Changed
- chore: update releases for Sprint 2 by @Amy-Leadem in #6549
- Add ADR for search input component by @JAMI-GIBBS in #6541
- Chore(deps): Bump js-yaml from 3.14.2 to 3.15.0 by @dependabot[bot] in #6552
- fix(patterns): stop /patterns.html collision from example snippets by @DANIEL-BRADY in #6531
- Update 00_word-list.md: Adding “elderly” and “non-VA or private” by @Lauren-Vocke in #6523
- Update numbers.md: Added guidance on negative numbers, measurements, … by @Lauren-Vocke in #6525
- Update index.md: Added guidance on labels and slim alert length by @Lauren-Vocke in #6528
- Add GitHub Action to enforce label on issues by @Tricia-Baker in #6546
- Update page-titles-and-section-titles.md: Added guidance on punctuati… by @Lauren-Vocke in #6524
- Update bulleted-lists.md: Adding info on 2-item lists and capitalization by @Lauren-Vocke in #6530
- 📊 Update metrics dashboard data - 2026-06-26 by @Amy-Leadem in #6545
- Adds guidance on how to write accessible text for image links by @Jeana-Clark in #6551
- Adds spacing between form title examples by @Jeana-Clark in #6563
- Update index.md: Removing label guidance by @Lauren-Vocke in #6571
- Chore(deps): Bump @department-of-veterans-affairs/component-library from 56.6.2 to 56.7.0 in the va-design-system-libraries group by @dependabot[bot] in #6572
- Chore(deps): Bump @department-of-veterans-affairs/css-library from 0.32.1 to 0.33.0 in the va-design-system-libraries group by @dependabot[bot] in #6587
- Metrics: Adds June 2026 monthly analytics report by @Matthew-Dingee in #6592
- Generate design tokens docs from css-library by @DANIEL-BRADY in #6521
- Added Error Persistence guidance by @Jeana-Clark in #6583
Full Changelog: https://va.ghe.com/software/vets-design-system-documentation/compare/Sprint-2…Sprint-3
What’s Changed
- Chore(deps): Bump form-data from 4.0.4 to 4.0.6 by @dependabot[bot] in #6474
- Chore(deps-dev): Bump tar from 7.5.11 to 7.5.16 by @dependabot[bot] in #6475
- chore: update releases for Sprint 1 by @Amy-Leadem in #6480
- Fix broken figma link by @Jeana-Clark in #6489
- Prevent lower environments from being indexed by search engines by @JAMI-GIBBS in #6473
- Chore(deps): Bump nokogiri from 1.19.3 to 1.19.4 in the bundler group across 1 directory by @dependabot[bot] in #6495
- Adds figma examples for “a single response” by @Jeana-Clark in #6493
- 📊 Update metrics dashboard data - 2026-06-19 by @Amy-Leadem in #6496
- 📊 Update pattern adherence data - 2026-06-22 by @Amy-Leadem in #6497
- Chore(deps): Bump concurrent-ruby from 1.3.5 to 1.3.7 in the bundler group across 1 directory by @dependabot[bot] in #6498
- Pattern adherence: Adds prefill fidelity tier breakdown by @Matthew-Dingee in #6500
- Create may-2026.md: Adding file for May 2026 content updates by @Lauren-Vocke in #6449
- Pattern adherence: Analyze only Maintained (production) forms by @Matthew-Dingee in #6502
- Pattern adherence: fix top-level app matching for all 9 patterns by @Matthew-Dingee in #6505
- Adds period to Hint text of SSN and VA file number in Content Considerations by @Derek-Wang in #6503
- Create workflow for automatic sprint issue generation by @Tricia-Baker in #6539
- Add automated sprint issue creation workflow by @Tricia-Baker in #6540
- Chore(deps): Bump the va-design-system-libraries group across 1 directory with 2 updates by @dependabot[bot] in #6514
Full Changelog: https://va.ghe.com/software/vets-design-system-documentation/compare/Sprint-1…Sprint-2
What’s Changed
Tokens
- Updated hard-coded values in web components to use recently added CSS-Library tokens by @Kerry-Powell in #2206
va-alert
- Added non-breaking space so sr-text doesn’t run into alert headings by @Jeana-Clark in #2197
va-telephone
- Used libphonenumber-js/min metadata to slim bundle by @Adrian-Rollett in #2216
va-file-input
- Fixed hint text not announcing with screen readers by @Kerry-Powell in #2196
Font resize component
- Fixed font resizing issues for va-additional-info, va-date, va-memorable-date, va-search-input, va-telephone-input, and va-text-input by @Amy-Leadem in #1800
va-file-input-multiple
- Fixed alignment issue with label and file target by @Kerry-Powell in #2222
va-tag-status
- Defined a font-family for the status text by @JAMI-GIBBS in #2227
CSS-Library
- Replaced hard-coded font-sizes with tokens by @JAMI-GIBBS in #2209
- Added additional color and font variables by @DANIEL-BRADY in #2224
dependency updates
- Add @stencil/postcss/postcss resolution and other security updates by @dependabot[bot] in #2207
- Bump brace-expansion by @dependabot[bot] in #2205
- Bump the npm_and_yarn group across 3 directories with 4 updates by @dependabot[bot] in #2217
What’s Changed
New Features & Components 🎉
- web-components: retry transient lazy import() failures by @Adrian-Rollett in #2165
Fixes
- [Tokens] va-select, va-service-list, va-sidenav, va-sort, va-statement-of-truth, va-summary-box, va-table, va-tabs, va-tag-status, va-telephone, va-telephone-input, va-text-input, va-textarea : replace hard-coded values by @Kerry-Powell in #2191
- [Tokens] globals and mixins: replace hard-coded css-values by @Kerry-Powell in #2193
- Fix error state visual regression by @JAMI-GIBBS in #2200
Full Changelog: https://va.ghe.com/software/component-library/compare/v56.8.0…v56.9.0
What’s Changed
New Features & Components 🎉
- va-header-minimal, va-icon, va-language-toggle, va-link, va-link-action, va-loading-indicator, va-maintenance-banner, va-memorable-date, va-minimal-footer, va-modal, va-need-help, va-notification
- Replaced hard-coded values with design system tokens. By @Kerry-Powell in #2183
- va-official-gov-banner, va-omb-info, va-on-this-page, va-pagination, va-privacy-agreement, va-process-list, va-progress-bar, va-promo-banner, va-radio, va-radio-option, va-search-filter, va-segmented-progress-bar
- Replaced hard-coded values with design system tokens. By @Kerry-Powell in #2189
Fixes
- va-header-minimal
- Updated linked logos alt text. By @Jeana-Clark in #2185
- Dependency update
- Updated js-yaml, babel-loader. By @dependabot[bot] in #2179
- Updated to latest CSS-Library release: v0.33.0. By @JAMI-GIBBS in #2190
- Updated README for CSS-Library and component-library packages for NPM. By @JAMI-GIBBS in #2192
Full Changelog: https://va.ghe.com/software/component-library/compare/v56.7.0…v56.8.0
August 2026
Content style guide
Links
-
Revised consideration about putting links on their own line to add “generally”:
We generally put links on their own line to help make the page easier to scan and the intention of the link as clear as possible. Too many embedded links can be distracting or overwhelming to people with traumatic brain injuries or other cognitive impairments.
-
Added information on how to structure link text for links that go to a site outside of VA.gov:
If the link takes the reader outside of VA.gov, name the external website in the link text. Put the action first (“Learn more about vaccines”) then the destination (“on the CDC website”) to lead with the value to the Veteran. We prefer to include the location in the main link text instead of in parentheses, like “Learn more about vaccines on the CDC website” and not “Learn more about vaccines (CDC website).”
Use a link label that tells the reader where the link takes them. We prefer including the location in the main link text instead of in parentheses since it’s clearer for screen readers and translated text. For example, “Play the YouTube video on creating an account” and not “Play the video on creating an account (YouTube).” But it’s okay to use parentheses if needed because of space constraints or to make the link text clearer.
-
Replaced “abilities” with “ways of interacting with the information”:
Avoid using words that assume certain ways of interacting with the information, like “See,” “Hear,” and “Watch.”
-
Updated guidance on links opening in a new tab to align with previous guidance. Links should only open in a new tab if the person will lose progress or unsaved data, regardless of the link’s destination:
Note: Links should open in the same tab, unless they meet the specific criteria for opening in a new tab. If a link needs to open in a new tab, add “(opens in a new tab)” to notify the person. Don’t use the new window icon unless there are space constraints.
Review guidance on when to open links in a new tab in the Components section
-
Added information on anchor and jump links:
We sometimes use an anchor or jump link when we need to link to a section within a VA.gov page. Anchor or jump links can be helpful in certain cases, like when we want to direct someone to a specific section on a long page. But if the heading of the section we’re linking to ever changes, the anchor or jump link won’t work and will redirect to the top of the page. Use anchor and jump links with caution.
-
Added information on how to structure link text for online forms:
Link text for forms
- Links to the form Detail page follow this format: Get VA Form XX-XXXX to download.
- Links to the online tool should include a verb and the purpose of the form. For example: Apply for healthcare benefits.
Note: If it will make the purpose of the link clearer, include “online” in the link text (“Apply for healthcare benefits online”). But if including “online” will be too repetitive or if a form only has an online version (no PDF option), you don’t need to include “online.”
- Updated all mentions of “form’s About page” to “form Detail page”
- Made edits throughout to align with the style guide
Components
Link
-
Updated guidance on links opening in a new tab to align with previous guidance:
- Open all links in the same tab, with one exception. Only open links in a new tab if selecting the link would cause the person to lose progress or unsaved data. In all other cases, links should open in the same tab.
- Always notify the person when opening in a new tab. Add “(opens in a new tab)” text to the link and use the external link variation. Don’t use the new tab icon unless there are space constraints.
Note: The external link variation applies to links that open in a new tab, not links that take people to a site outside of VA.gov.
- Links to a non-VA.gov site must indicate where they go. Follow the methods detailed in linking to external sites.
- Links that open in a new tab must indicate that. By default, the link component’s external link variation will add “(opens in a new tab)” to the link text instead of using an icon. This follows Techniques for WCAG 2.0 advice on providing people with both a spoken and visual warning that this link opens in a new tab.
-
Made edits throughout to align with the style guide