About
USWDS Changelog
Latest code, guidance, and content updates across the design system.
| Date | USWDS version | Page | Affects | Description |
|---|---|---|---|---|
| 2025-02-14 | N/A | Step indicator |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3098 |
| 2025-02-14 | N/A | Step indicator accessibility tests |
|
Added accessibility tests page. More information: uswds-site#3098 |
| 2025-02-14 | N/A | Modal |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3103 |
| 2025-02-14 | N/A | Modal accessibility tests |
|
Added accessibility tests page. More information: uswds-site#3103 |
| 2025-02-14 | N/A | Card |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#3101 |
| 2025-02-14 | N/A | Card accessibility tests |
|
Added accessibility tests page. More information: uswds-site#3101 |
| 2025-02-11 | N/A | Pattern: Gender identity and sex |
|
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 | Pattern: Gender identity and sex |
|
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 | Pattern: Gender identity and sex |
|
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 | Pattern: Pronouns |
|
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 | Pattern: Gender identity and sex |
|
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-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 | Radio buttons |
|
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 |
| 2024-08-13 | N/A | List accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2746 |
| 2024-08-13 | N/A | Identifier |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2754 |
| 2024-08-13 | N/A | Identifier accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2754 |
| 2024-08-13 | N/A | Header |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2761 |
| 2024-08-13 | N/A | Header accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2761 |
| 2024-08-13 | N/A | Footer |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2760 |
| 2024-08-13 | N/A | Footer accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2760 |
| 2024-07-26 | N/A | Monthly calls |
|
Added June 2024 monthly call. More information: uswds-site#2747 |
| 2024-06-26 | N/A | Utilities |
|
Fixed example in settings.
Added missing comma to color example in |
| 2024-06-19 | N/A | Text input |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2697 |
| 2024-06-19 | N/A | Text input accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2697 |
| 2024-06-19 | N/A | Select |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2702 |
| 2024-06-19 | N/A | Select accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2702 |
| 2024-06-19 | N/A | Search |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2694 |
| 2024-06-19 | N/A | Search accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2694 |
| 2024-06-14 | N/A | Monthly calls |
|
Added May 2024 monthly call. More information: uswds-site#2708 |
| 2024-06-07 | N/A | Migrating to 3.0 |
|
Added note about Autoprefixer to Sass compilation section. More information: uswds-site#2319 |
| 2024-06-07 | N/A | Tooltip |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2646 |
| 2024-06-07 | N/A | Tooltip accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2646 |
| 2024-06-07 | N/A | Icon |
|
Added clarity to icon guidance. More information: uswds-site#2643 |
| 2024-06-07 | N/A | Date range picker |
|
Added known issues section. More information: uswds-site#2620 |
| 2024-06-07 | N/A | Banner |
|
Added WCAG compliance tag and accessibility test status section. More information: uswds-site#2687 |
| 2024-06-07 | N/A | Banner accessibility tests |
|
Added accessibility tests page. More information: uswds-site#2687 |