About
What's new?
Guidance Updates
What’s Changed
- Adds Experimental Design Requests Dashboard to VADS by @derekwang99 in #5491
- Update 00_word-list.md: Adding new and updating current entries by @laurenvocke-va in #5237
- 📊 Update metrics dashboard data - 2026-01-16 by @humancompanion-usds in #5486
- Guidance updates: Revise exceptions for component selection guidance by @babsdenney in #5320
- Address pattern: Update documentation to clarify profile update information in address guidance by @eileen-coforma in #5495
- Search: Adds an initial llms file by @humancompanion-usds in #5496
- Button: Remove inconsistent sizing information by @danbrady in #5492
- Bump dev env workflow node ver by @danbrady in #5510
- Update to component-library v54.5.2 by @danbrady in #5509
- chore: update releases for Sprint 20 by @humancompanion-usds in #5512
- Bump tar from 6.2.1 to 7.5.3 in the npm_and_yarn group across 1 directory by @dependabot[bot] in #5490
- Add info about imposter patterns and templates by @allison0034 in #5521
- feat: Add doc-queue skill for processing documentation issues by @humancompanion-usds in #5516
- 📊 Update metrics dashboard data - 2026-01-23 by @humancompanion-usds in #5519
- Bump the npm_and_yarn group across 1 directory with 3 updates by @dependabot[bot] in #5517
- Add html-proofer link checker and fix 57 broken links by @humancompanion-usds in #5530
- Tag-Status: Change informational tag status reference to ‘info’ by @babsdenney in #5464
- Add align-self utility documentation to flexbox page by @humancompanion-usds in #5527
- Alert: Add guidance on choosing between alert statuses by @humancompanion-usds in #5532
- Update sort screenshot by @derekwang99 in #5533
- Add results description guidance to Pagination component by @humancompanion-usds in #5534
- Update eligibility pattern guidance #5025 by @humancompanion-usds in #5535
- add line about tag context by @jeana-adhoc in #5562
- Tags: Add links to shared content for tags by @babsdenney in #5552
- tag-status: fix broken preview and links by @powellkerry in #5583
- Add accessibility guidance for wrapping content in va-additional-info by @humancompanion-usds in #5544
- Alert - Expand slim alert usage guidelines to include cards by @eileen-coforma in #5514
- Apply contractions to Tag component for consistency with Tag Status by @Copilot in #5606
- Update tag-status.md for clarity and consistency by @caw310 in #5599
Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-20…Sprint-21
What’s Changed
- [WIP] Address feedback on new form respondent pattern by @Copilot in #5149
- Add error handling to mermaid.run() promise by @Copilot in #5340
- chore: update releases for Sprint 18 by @humancompanion-usds in #5354
- 📊 Update metrics dashboard data - 2025-12-19 by @humancompanion-usds in #5351
- Delete src/_content-style-guide/we-us-you.md by @laurenvocke-va in #5352
- Delete src/_content-style-guide/they-their.md by @laurenvocke-va in #5353
- Update sign-in-and-identity-verification.md: ID.me and Login.gov changes by @laurenvocke-va in #5343
- Adds the latest looker report by @humancompanion-usds in #5370
- 📊 Update metrics dashboard data - 2025-12-26 by @humancompanion-usds in #5362
- Update component-library and css-library packages to latest release by @jamigibbs in #5375
- chore: update releases for Sprint 19 by @humancompanion-usds in #5379
- Add loading overlay for Mermaid charts by @babsdenney in #5333
- 📊 Update metrics dashboard data - 2026-01-02 by @humancompanion-usds in #5367
- Update links.md: Adding and revising guidance by @laurenvocke-va in #5246
- Update bulleted-lists.md: Changing Links in lists section by @laurenvocke-va in #5245
- 📊 Update metrics dashboard data - 2026-01-07 by @humancompanion-usds in #5407
- [Metrics] Ports over the workflow from component-library for weekly reports by @humancompanion-usds in #5406
- Sort: Creates usage, behavior, content, and accessibility guidance by @derekwang99 in #5102
- Create december-2025.md: Adding file for Dec 2025 updates by @laurenvocke-va in #5376
- Pattern: Start of new form respondent pattern: Help users to identify who is filling out a form by @humancompanion-usds in #5075
- OMB Info: Remove word “View” from OMB info button by @babsdenney in #5441
- Adds the looker report for December and attempts to correct the component usage data. by @humancompanion-usds in #5459
- Update index.md by @caw310 in #5473
- Form submitter pattern: Add figma link and anchors by @eileen-coforma in #5467
- Sort: Updates results description guidance and component placement guidance, adds Figma link and examples by @derekwang99 in #5462
Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-18…Sprint-20
What’s Changed
- chore: update releases for Sprint 18 by @humancompanion-usds in #5354
- 📊 Update metrics dashboard data - 2025-12-19 by @humancompanion-usds in #5351
- Delete src/_content-style-guide/we-us-you.md by @laurenvocke-va in #5352
- Delete src/_content-style-guide/they-their.md by @laurenvocke-va in #5353
- Update sign-in-and-identity-verification.md: ID.me and Login.gov changes by @laurenvocke-va in #5343
- Adds the latest looker report by @humancompanion-usds in #5370
- 📊 Update metrics dashboard data - 2025-12-26 by @humancompanion-usds in #5362
- Update component-library and css-library packages to latest release by @jamigibbs in #5375
Full Changelog: https://github.com/department-of-veterans-affairs/vets-design-system-documentation/compare/Sprint-18…Sprint-19
VADS Component Library Releases
What’s Changed
Bug fixes
| Component | Summary | API change | Rendered markup change |
|---|---|---|---|
| va-button | Reverted the submit action timing change introduced in v54.6.0. Testing revealed that this change introduced possible complications with downstream implementations. By @amyleadem #1972 | No | No |
Dependency updates
| Affected package | Dependency name | Before | After |
|---|---|---|---|
| design-system-dashboard-cli | glob | 13.0.0 | 13.0.1 |
| react-components | glob | 13.0.0 | 13.0.1 |
By @powellkerry #1969, #1971
Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v54.6.0…v54.6.1
What’s Changed
New Features & Components 🎉
| Component | Summary | | :—- | :—- | | va-card-status | Added the Card Status component. The new va-card-status component is a structured card that uses required fields to keep status messages consistent. By @ediiotero https://github.com/department-of-veterans-affairs/component-library/pull/1862 |
Bug fixes
| Component | Summary | API change | Rendered markup change |
| :—- | :—- | :—- | :—- |
| va-button | Fixed a timing bug in va-button that prevented some forms from submitting as expected. The button now runs its onClick action before onSubmit. By @ediiotero https://github.com/department-of-veterans-affairs/component-library/pull/1946 | No | No |
| va-pagination | Fixed an issue in va-pagination that prevented icons from rendering when the icon sprite was stored in a custom location. The component now uses va-icon instead of hard-coded SVGs to prevent broken icon paths. By @jamigibbs https://github.com/department-of-veterans-affairs/component-library/pull/1956 | No | Yes |
Dependency updates
| Affected package | Dependency name | Before | After |
|---|---|---|---|
| design-system-dashboard-cli | eslint | 7.32.0 | 9.26.0 |
| glob | 9.3.5 | 13.0.0 | |
| lodash | 4.17.21 | 4.17.23 | |
| react-components | eslint | 7.19.0 | 9.26.0 |
| glob | 9.3.5 | 13.0.0 | |
| web-components | eslint | 8.19.0 | 9.26.0 |
Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v54.5.2…v54.6.0
What’s Changed
Fixes
- Remove i18n from react-components package by @RyanMunsch in #1950
Full Changelog: https://github.com/department-of-veterans-affairs/component-library/compare/v54.5.1…v54.5.2
Figma Component Library Changelog
Content Style Guide Updates
January 2026
Content style guide
We, us, you
Removed this section. The guidance is available in the Use conversational language section.
They, their
Removed this section. The guidance is available in the Neutral language section.
Sign in and identity verification
- Changed the order of accounts in the text so ID.me comes before Login.gov.
- Removed the guidance to emphasize using Login.gov.
- Revised the guidance explaining that ID.me and Login.gov are accounts and not separate tools:
Research has shown that some people confuse Login.gov with being a separate tool, and some people think they need to go to the ID.me or Login.gov websites to sign in rather than VA.gov. So, we reinforce that ID.me and Login.gov are types of sign-in accounts—not separate tools or websites—by using the phrase “ID.me account” or “Login.gov account.”
- Added guidance on the term “DS Logon”:
VA no longer offers the ability to sign in with a DS Logon username and password. Use this term only in reference to this option going away or the ability to use this option for Defense Department (DOD) websites.
- Added guidance on using the “MFA” acronym: Introduce “MFA” on the first mention and use “MFA” on any subsequent mentions on the same page.
- Updated the “My HealtheVet” guidance:
With rare temporary exceptions, VA no longer offers the My HealtheVet user ID and password option for sign in. Today, My HealtheVet on VA.gov refers instead only to the health portal on VA.gov. When using this term to refer to the portal, “My HealtheVet” is 2 words. Don’t italicize the “e” between “Health” and “Vet” in digital content body copy, headlines, or user interface elements such as links, buttons, and navigation. The “e” is italicized only in the logo and in print materials.<p> Note: We no longer tell Veterans to create new My HealtheVet accounts or upgrade existing accounts. We don’t use the terms “My HealtheVet basic,” “My HealtheVet advanced,” or “My HealtheVet Premium.” Don’t refer to the sign-in account Veterans use to access their health portal as a My HealtheVet account. Instead, refer to the type of sign-in account (ID.me or Login.gov) or simply “your sign-in account.”
- Added “My HealtheVet account” to the retired terms and updated the guidance:
With rare temporary exceptions, VA no longer offers this sign-in option. Don’t refer to the sign-in account Veterans use to access their health portal as a My HealtheVet account. Instead, refer to the type of sign-in account (ID.me or Login.gov) or simply “your sign-in account.”
Links
- Updated the Considerations section to make guidance clearer:
• We use links to connect Veterans and other visitors with related information that may be helpful to them.
• We 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.
• We tell people where links are taking them and why. External links can be disorienting for all people, but especially people who use screen readers. - Updated guidance in the Link text section to make guidance clearer:
• Describe the purpose of the linked page
• If the link takes the reader outside of VA.gov, name the external website in the link text
• Balance link text length to provide the needed descriptions without having the relevant words get lost in the length
• Use “Select” instead of “Click here,” since not all people are physically clicking links - Added a new section on linking to forms: linking to the form’s About page instead of the PDF (applies to all content other than the form’s About page), linking directly to the form’s PDF on the About page, and added exceptions for links to the direct download to the PDF version:
• For forms that aren’t part of the VA forms database, you may need to use a direct download link to the PDF version of the form. This is a rare situation. Contact the centralized content and information architecture (IA) team for guidance.
• You may also need a direct download link if the person filling out the form is downloading and generating their own completed copy. Contact the centralized content and IA team for guidance. - Added new guidance in the Linking to documents and other file sources section:
• If a link opens a calendar, YouTube video, XLS, or other file format, add the relevant icon from the Components section in the Design System. This does not apply to pages housed within Drupal.
• Include the file format (ex. PDF, HTML, or XML) in the link label. Place the file format at the end of the link label in parentheses. For example, “Download the Continuity of Care document (PDF).”
• If you have a list of links to the same document with different file formats, consider rewording the link text to include the file format earlier. Contact the centralized content and IA team for help with your link text. - Added guidance on not linking to the Code of Federal Regulations on VA.gov pages.
- Added a new section on Links in lists that includes general guidance and 3 options for adding links to lists.
Bulleted and numbered lists
Updated the Links in lists section to include 3 options for adding links to lists
Word list
- Updated entries:
apply: updated the examples
delete: clarified this is specifically for file uploads
educational and career counseling: removed note on style differences on Education and Career Counseling pages
educational counseling: removed note on style differences on Education and Career Counseling pages
Montgomery GI Bill Active Duty (MGIB-AD): added information on using the acronym and “Chapter 30”
Montgomery GI Bill Selected Reserve (MGIB-SR): added information on using the acronym and “Chapter 1606”
My HealtheVet: added that this is 2 words
upload: clarified this is specifically for file uploads
Veteran Readiness and Employment (VR&E): added information on using the acronym and “Chapter 31”; added information about the previous names for the program - Added new entries:
approved program
copay (or copayment, or health care copay)
copay bill (or patient statement, or billing statement)
cover the costs/cover expenses
debt
dependent child
education benefit
eligible
entitlement
get paid back
Montgomery GI Bill
national tests
non-qualifying period of service
overpayment or overpayment debt
Personalized Career Planning and Guidance (PCPG)
Post-9/11 GI Bill (PGIB)
preparatory courses or prep courses
Primary Family Caregiver
qualify
relinquish your benefits
Secondary Family Caregiver
spouse
Statement of Service
verify and verification
VET TEC 2.0
waiver (debt forgiveness)