What’s new
Get the latest USWDS news and information here. Learn more about our product development and process, dive deeper into our monthly call topics, and see how we work with our partners to improve the government technology space.
-
Release notes
Find summaries of each USWDS update on our GitHub releases page. Release notes explain bug fixes, new features, and other changes.
-
GitHub discussions
How our growing community of government engineers, content specialists, and designers participate and contribute to improving USWDS.
Latest changes to USWDS
Meaningful code, guidance, and content updates across the design system are listed in the following table:
| Date | USWDS version | Page | Affects | Description |
|---|---|---|---|---|
| 2025-07-15 | N/A |
|
Added Export Compliance Assistance Program (ECAP) to the showcase page. More information: uswds-site#2839 |
|
| 2025-06-02 | N/A |
|
Published our new USWDS component Accessibility Conformance Report (ACR) / Voluntary Product Accessibility Template (VPAT®). More information: uswds-site#3162 |
|
| 2025-05-23 | 3.13.0 |
|
Added a new HTML Web Component-based variant of the banner. More information: uswds#6460 |
|
| 2025-05-02 | N/A |
|
Replacing all references to chat.18f.gov. 18f.gov was decommissioned, preventing people from accessing this form. Now linking directly instead. More information: uswds-site#1849 |
|
| 2025-04-30 | N/A |
|
Rephrasing compliance tag to reflect industry standard: “failed,” rather than “does not pass.” More information: uswds-site#3155 |
|
| 2025-04-30 | N/A |
|
Removed Dan Williams from the community managers section and added Anne Petersen. More information: uswds-site#1849 |
|
| 2025-04-24 | N/A |
|
Added accessibility test results page. More information: uswds-site#3156 |
|
| 2025-04-24 | N/A |
|
Added accessibility tests page. More information: uswds-site#3156 |
|
| 2025-03-26 | 3.12.0 |
|
Added note about the deprecation of the validation component after v3.12.0. More information: uswds-site#3149 |
|
| 2025-03-26 | N/A |
|
Added accessibility tests page. More information: uswds-site#3150 |
|
| 2025-03-26 | N/A |
|
Added accessibility tests page. More information: uswds-site#3150 |
|
| 2025-03-14 | N/A |
|
Added accessibility tests page. More information: uswds-site#3146 |
|
| 2025-03-07 | 3.12.0 |
|
Replaced |
|
| 2025-03-07 | 3.12.0 |
|
Replaced |
|
| 2025-03-07 | 3.12.0 |
|
Replaced |
|
| 2025-03-07 | 3.12.0 |
|
Enabled tooltip functionality on non-button elements. More information: uswds#6035 |
|
| 2025-03-07 | 3.12.0 |
|
Updated the width of the label’s target area to match the width of the content. Previously, the interactive area extended the full width of the container. More information: uswds#6192 |
|
| 2025-03-07 | 3.12.0 |
|
Added the |
|
| 2025-03-07 | 3.12.0 |
|
Fixed a bug that prevented in-page navigation from scrolling to nested headings. The in-page navigation can now smooth scroll to headings within components like card and summary box. More information: uswds#5878 |
|
| 2025-03-07 | 3.12.0 |
|
Enabled native JavaScript translation for calendar labels.
The calendar now uses the |
|
| 2025-03-07 | 3.12.0 |
|
Updated the width of the label’s target area to match the width of the content. Previously, the interactive area extended the full width of the container. More information: uswds#6192 |
|
| 2025-02-21 | N/A |
|
Updated resources, copy and links throughout page. More information: uswds-site#3053 |
|
| 2025-02-14 | N/A |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3098 |
|
| 2025-02-14 | N/A |
|
Added accessibility tests page. More information: uswds-site#3098 |
|
| 2025-02-14 | N/A |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3103 |
|
| 2025-02-14 | N/A |
|
Added accessibility tests page. More information: uswds-site#3103 |
|
| 2025-02-14 | N/A |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3101 |
|
| 2025-02-14 | N/A |
|
Added accessibility tests page. More information: uswds-site#3101 |
|
| 2025-02-11 | N/A |
|
Removed gender identity pattern. Removed content related to the January 20, 2025 Executive Order, "Defending Women from Gender Ideology Extremism And Restoring Biological Truth To The Federal Government". More information: uswds-site#3099 |
|
| 2025-02-11 | N/A |
|
Updated sex pattern to include only options for "Male" and "Female". Updated content related to the January 20, 2025 Executive Order, "Defending Women from Gender Ideology Extremism And Restoring Biological Truth To The Federal Government". More information: uswds-site#3099 |
|
| 2025-02-11 | N/A |
|
Updated references. Updated references to refer only to guidance related to the January 20, 2025 Executive Order, "Defending Women from Gender Ideology Extremism And Restoring Biological Truth To The Federal Government". More information: uswds-site#3099 |
|
| 2025-02-11 | N/A |
|
Removed pronouns pattern. Removed content related to the January 20, 2025 Executive Order, "Defending Women from Gender Ideology Extremism And Restoring Biological Truth To The Federal Government". More information: uswds-site#3099 |
|
| 2025-02-10 | N/A |
|
Replaced dead hyperlinks with archived copy. Replaced references to fcsm.gov with plain text and a link to the archived page on archive.org. More information: uswds-site#3092 |
|
| 2025-01-30 | N/A | Pattern: Gender identity and sex |
|
Added content alert. This pattern is affected by a recent change in law, policy, or regulation. Expect changes to this pattern in the near future as we adapt to these new requirements. More information: uswds-site#3090 |
| 2025-01-30 | N/A | Pattern: Race and ethnicity |
|
Replaced dead hyperlink with archived copy. Replaced “Latinx identity in design, tech, and government” link with plain text and a link to the archived page on archive.org. More information: uswds-site#3088 |
| 2025-01-30 | N/A | Pattern: Pronouns |
|
Added an archive.org link to the “The importance of personal pronouns” reference link. More information: uswds-site#3088 |
| 2025-01-30 | N/A | Pattern: Pronouns |
|
Added content alert. This pattern is affected by a recent change in law, policy, or regulation. Expect changes to this pattern in the near future as we adapt to these new requirements. More information: uswds-site#3090 |
| 2025-01-23 | N/A | Together: Introduction |
|
Removed report. Removed content related to the January 20, 2025 Executive Order, "Ending Radical And Wasteful Government DEI Programs And Preferencing". More information: uswds-site#3078 |
| 2025-01-23 | N/A | Together: What's Next |
|
Removed report. Removed content related to the January 20, 2025 Executive Order, "Ending Radical And Wasteful Government DEI Programs And Preferencing". More information: uswds-site#3078 |
| 2025-01-23 | N/A | Together: Get Involved |
|
Removed report. Removed content related to the January 20, 2025 Executive Order, "Ending Radical And Wasteful Government DEI Programs And Preferencing". More information: uswds-site#3078 |
| 2025-01-23 | N/A | Together: Findings |
|
Removed report. Removed content related to the January 20, 2025 Executive Order, "Ending Radical And Wasteful Government DEI Programs And Preferencing". More information: uswds-site#3078 |
| 2025-01-23 | N/A | Patterns overview |
|
Removed report link and introduction. Removed content related to the January 20, 2025 Executive Order, "Ending Radical And Wasteful Government DEI Programs And Preferencing". More information: uswds-site#3078 |
| 2025-01-23 | N/A | Pattern: Pronouns |
|
De-linked dead hyperlink in references. De-linked pronouns reference link. More information: uswds-site#3078 |
| 2025-01-23 | N/A | Inclusive design |
|
Removed inclusive design page. Removed content related to the January 20, 2025 Executive Order, "Ending Radical And Wasteful Government DEI Programs And Preferencing". More information: uswds-site#3078 |
| 2025-01-23 | N/A | Research |
|
Removed Together report link. Removed content related to the January 20, 2025 Executive Order, "Ending Radical And Wasteful Government DEI Programs And Preferencing". More information: uswds-site#3078 |
| 2025-01-22 | N/A | Pattern: Gender identity and sex |
|
Updated the urls for broken links. Replaced the urls for “Executive Order 14075”, “Recommendations on the best practices for the collection of sexual orientation and gender identity data on federal statistical surveys”, and “X gender marker available on U.S. Passports starting April 11” links. More information: uswds-site#3068 |
| 2025-01-22 | N/A | Pattern: Language preferences |
|
Updated the url for the “OMB memorandum m-17-06” link. More information: uswds-site#3068 |
| 2025-01-22 | N/A | Inclusive design |
|
Updated the urls for the “Priority 2 Executive Order” and “Executive Order 13985” links. More information: uswds-site#3068 |
| 2025-01-22 | N/A | Design principles |
|
Updated the url for the “Delivering Excellent, Equitable, and Secure Federal Services and Customer Experience” link. More information: uswds-site#3068 |
| 2025-01-22 | N/A | Link |
|
Updated the url for the “OMB M-23-22” link. More information: uswds-site#3068 |
| 2025-01-14 | N/A | Site alert |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3049 |
| 2025-01-14 | N/A | Site alert accessibility tests |
|
Added accessibility tests page. More information: uswds-site#3049 |
| 2025-01-14 | N/A | Date range picker |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3052 |
| 2025-01-14 | N/A | Date range picker accessibility tests |
|
Added accessibility tests page. More information: uswds-site#3052 |
| 2025-01-14 | N/A | Date picker |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3051 |
| 2025-01-14 | N/A | Date picker accessibility tests |
|
Added accessibility tests page. More information: uswds-site#3051 |
| 2025-01-14 | N/A | Alert |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3048 |
| 2025-01-14 | N/A | Alert accessibility tests |
|
Added accessibility tests page. More information: uswds-site#3048 |
| 2025-01-13 | N/A | Monthly Calls |
|
Added December 2024 monthly call. Added November monthly call video. More information: uswds-site#3044 |
| 2025-01-08 | N/A | Getting started for designers |
|
Updated information about USWDS design kit for Adobe XD. Noted that we have stopped maintaining these assets since XD is no longer supported by Adobe. More information: uswds-site#3041 |
| 2025-01-08 | N/A | Getting started for designers |
|
Added information about USWDS design kit for Figma. Added download link and direct link to file hosted on Figma community. Removed links to third-party Figma kits. More information: uswds-site#3041 |
| 2024-12-19 | N/A | Button group |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3009 |
| 2024-12-19 | N/A | Button group accessibility tests |
|
Added accessibility tests page. More information: uswds-site#3009 |
| 2024-12-18 | N/A | Showcase |
|
Removed broken link to VA Caseflow. More information: uswds-site#3031 |
| 2024-12-18 | N/A | Getting started for developers: Phase 2 |
|
Added documentation for |
| 2024-12-18 | 3.11.0 | Text input |
|
Moved |
| 2024-12-18 | 3.11.0 | Table |
|
Updated table header styles to be consistent across all table elements.
Now, all |
| 2024-12-18 | N/A | Process list |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3007 |
| 2024-12-18 | N/A | Process list accessibility tests |
|
Added accessibility tests page. More information: uswds-site#3007 |
| 2024-12-18 | 3.11.0 | Pagination |
|
Replaced deprecated |
| 2024-12-18 | 3.11.0 | Modal |
|
Replaced deprecated |
| 2024-12-18 | 3.11.0 | Input prefix or suffix |
|
Replaced deprecated |
| 2024-12-18 | 3.11.0 | Input prefix or suffix |
|
Moved |
| 2024-12-18 | 3.11.0 | Icon |
|
Replaced deprecated |
| 2024-12-18 | N/A | Icon |
|
Removed deprecated |
| 2024-12-18 | 3.11.0 | Icon list |
|
Replaced deprecated |
| 2024-12-18 | N/A | Icon list |
|
Removed deprecated |
| 2024-12-18 | 3.11.0 | Form |
|
Moved |
| 2024-12-18 | 3.11.0 | Footer |
|
Removed |
| 2024-12-18 | 3.11.0 | File input |
|
Replaced deprecated |
| 2024-12-18 | 3.11.0 | File input |
|
Fixed a bug that prevented screen readers from announcing the invalid file type error message. More information: uswds#6168 |
| 2024-12-18 | N/A | Collection |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3010 |
| 2024-12-18 | 3.11.0 | Collection |
|
Replaced deprecated |
| 2024-12-18 | N/A | Collection accessibility tests |
|
Added accessibility tests page. More information: uswds-site#3010 |
| 2024-12-17 | N/A | Summary box |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3016 |
| 2024-12-17 | N/A | Summary box accessibility tests |
|
Added accessibility tests page. More information: uswds-site#3016 |
| 2024-12-13 | N/A | Icon list |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3008 |
| 2024-12-13 | N/A | Icon list accessibility tests |
|
Added accessibility tests page. More information: uswds-site#3008 |
| 2024-12-13 | N/A | Monthly Calls |
|
Added November 2024 monthly call. More information: uswds-site#3015 |
| 2024-11-6 | 3.9.0 | Modal |
|
Added focus trap guidance. Updated guidance to ensure users trap focus inside the modal so that it doesn’t move to the content behind it. More information: uswds-site#2874 |
| 2024-11-20 | N/A | What's new |
|
Combined “What’s new” and “News and updates” pages. More information: uswds-site#2958 |
| 2024-11-19 | N/A | Memorable date |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2919 |
| 2024-11-19 | N/A | Memorable date accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2919 |
| 2024-11-19 | N/A | File input |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2963 |
| 2024-11-19 | N/A | File input accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2963 |
| 2024-11-19 | N/A | Date range picker |
|
Added guidance about always allowing users to type in the date manually. More information: uswds-site#2822 |
| 2024-11-19 | N/A | Date picker |
|
Added guidance about always allowing users to type in the date manually. More information: uswds-site#2822 |
| 2024-11-13 | 3.10.0 | Time picker |
|
Updated the time picker hint text to improve clarity. This update allows the component to meet the success criteria in WCAG 3.3.2. More information: uswds#6147 |
| 2024-11-13 | 3.10.0 | Step indicator |
|
Removed the |
| 2024-11-13 | 3.10.0 | Modal |
|
Fixed a bug that prevented bundling the modal package with a custom prefix. This update removed hard-coded class names from the modal JavaScript. More information: uswds#6026 |
| 2024-11-13 | 3.10.0 | File input |
|
Fixed a bug that caused image previews to break when a Content Security Policy is enabled. The component now uses event listeners in place of inline JavaScript to handle error states. More information: uswds#5997 |
| 2024-11-13 | 3.10.0 | Combo box |
|
Updated the order of combo box search results. The component now displays options that start with the query at the top of the list, followed by options that contain the query. This behavior more closely aligns with user expectations. More information: uswds#6122 |
| 2024-11-13 | 3.10.0 | Checkbox |
|
Removed style tags from indeterminate checkbox SVGs. These style tags were unnecessary and caused a conflict with some automated testing tools. More information: uswds#6162 |
| 2024-11-07 | N/A | Time picker |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2921 |
| 2024-11-07 | N/A | Time picker accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2921 |
| 2024-11-07 | N/A | Identifier |
|
Added clarification on parent agency. We added guidance to cover cases where a site has no higher-level agency. More information: uswds-site#2591 |
| 2024-11-06 | N/A | Layout grid utilities |
|
Refactored guidance page. Improved layout for easier scanning and consistency across other utility pages. More information: uswds-site#2276 |
| 2024-11-06 | N/A | Memorable date |
|
Added known issues section. More information: uswds-site#2716 |
| 2024-11-05 | 3.9.0 | Pattern: Keep a record |
|
Usability guidance content updated. More information: uswds-site#2939 |
| 2024-11-04 | N/A | Monthly Calls |
|
Added September and October 2024 monthly calls. More information: uswds-site#2934 |
| 2024-10-23 | N/A | Monthly Calls |
|
Added video for August 2024 monthly call. More information: uswds-site#2873 |
| 2024-10-16 | N/A | Side navigation |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2864 |
| 2024-10-16 | N/A | Side navigation accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2864 |
| 2024-10-16 | N/A | Pagination |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2865 |
| 2024-10-16 | N/A | Pagination accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2865 |
| 2024-10-16 | N/A | In-page navigation |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2863 |
| 2024-10-16 | N/A | In-page navigation accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2863 |
| 2024-10-16 | N/A | Breadcrumb |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2853 |
| 2024-10-16 | N/A | Breadcrumb accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2853 |
| 2024-10-15 | N/A | Pattern: Progress easily |
|
Added guidance for error messages and disabled states to the “what to do” and “what not to do” sections. More information: uswds-site#2744 |
| 2024-10-04 | 3.9.0 | Template: Create account |
|
Added the |
| 2024-10-04 | 3.9.0 | Settings |
|
Added new |
| 2024-10-04 | 3.9.0 | Site alert |
|
Fixed a bug that caused |
| 2024-10-04 | 3.9.0 | Pagination |
|
Added text underline styles to pagination links. Pagination links are now visually consistent with other USWDS text links. More information: uswds#5970 |
| 2024-10-04 | 3.9.0 | Memorable date |
|
Removed numeric representation of months from the |
| 2024-10-04 | 3.9.0 | Identifier |
|
Updated the USA.gov link in Spanish versions of the identifier. The link text now reads “Visite USAGov en Español” and the link url is now “https://www.usa.gov/es/”. More information: uswds#5892 |
| 2024-10-04 | 3.9.0 | Header |
|
Removed the CSS order property from mobile header navigation. Now, the visual order of the component matches the tab order. This is marked as a breaking change, but you only need to change your project code if you want to keep the search bar at the top of the menu. More information: uswds#6037 |
| 2024-10-04 | N/A | Form |
|
Added guidance discouraging most uses of disabled form inputs. We also added guidance on the rare instances when disabled inputs improve usability. More information: uswds-site#2776 |
| 2024-10-04 | 3.9.0 | Footer |
|
Added the |
| 2024-10-04 | 3.9.0 | Footer accessibility tests |
|
Updated the status of the WCAG 1.3.5 test to “pass”. The reported issue was fixed in the USWDS 3.9.0 release. More information: uswds-site#2765 |
| 2024-10-04 | 3.9.0 | Date range picker |
|
Added |
| 2024-10-04 | 3.9.0 | Date range picker |
|
Fixed a bug that caused |
| 2024-10-04 | 3.9.0 | Date picker |
|
Added |
| 2024-10-04 | 3.9.0 | Date picker |
|
Fixed a bug that caused |
| 2024-10-04 | 3.9.0 | Combo box |
|
Removed custom screen reader instructions. Combo box now relies on the default instructions provided by screen readers. More information: uswds#6022 |
| 2024-10-04 | 3.9.0 | Character count |
|
Enhanced visual cue when |
| 2024-10-04 | 3.9.0 | Card |
|
Fixed a bug that caused the component to ignore the |
| 2024-10-04 | 3.9.0 | Button |
|
Updated the width of unstyled buttons at narrow screen widths.
Now, unstyled buttons receive a width of |
| 2024-10-04 | 3.9.0 | Alert |
|
Fixed a bug that caused |
| 2024-09-26 | N/A | Website standards |
|
Updated content to reflect move to standards.digital.gov. More information: uswds-site#2843 |
| 2024-09-18 | N/A |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2821 |
|
| 2024-09-18 | N/A | Radio button accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2821 |
| 2024-09-18 | N/A | Combo box |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2811 |
| 2024-09-18 | N/A | Combo box accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2811 |
| 2024-09-18 | N/A | Checkbox |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2803 |
| 2024-09-18 | N/A | Checkbox accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2803 |
| 2024-09-16 | N/A | Monthly Calls |
|
Added August 2024 monthly call. More information: uswds-site#2827 |
| 2024-09-05 | N/A | Getting started for developers: Phase 2 |
|
Removed the version number from “Gulp 4” references. More information: uswds-site#2750 |
| 2024-09-05 | N/A | Getting started for developers: Phase 2 |
|
Added documentation for |
| 2024-08-13 | N/A | List |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2746 |
Latest updates
Meaningful code and guidance updates are listed in the following table:
| Date | Description |
|---|---|
| 2024-11-20 |
Combined “What’s new” and “News and updates” pages. More information: uswds-site#2958 |
| 2024-02-26 |
Added release notes section. More information: uswds-site#2318 |