Canvas v13 Announcements

Canvas v13.2 Release

Canvas v13.2 is now available in Canvas Kit React and CSS!

Deprecate Tokens

Old tokens from @workday/canvas-kit-react/tokens are now deprecated and will be removed in a future release. Please update your projects to use our new tokens from @workday/canvas-tokens-web. You can view the token docs here.

V2 Token Codemod

We’ve also added a codemod to help you automatically replace old tokens from @workday/canvas-kit-react/tokens with the new CSS variable-based tokens from @workday/canvas-tokens-web@2.

Token Migration Guide

To further assist with the transition, we’ve provided a token migration guide. This guide helps teams move from @workday/canvas-kit-react/tokens to @workday/canvas-tokens-web. It even includes an LLM migration mapping file (llm-token-migration.txt) specifically designed for use with LLM-based code assistants (like Cursor). Keep in mind, this file is for LLMs to automate and assist your migration, not for direct human reference. Read more about it here.

July 2025 Design Asset Release

We’ve released four new icons and new graphics to our Canvas Design Asset library this month to supercharge your product designs:

• New graphics for Google Translate to support the Translate Business Object task.
• To enhance conversational AI workflows for Workday Assistant, we’ve introduced a new directional arrow icon, perfect for displaying system-suggested prompts and directional cues. Additionally, three more directional arrow icons have been added to complete our comprehensive arrow set.

These asset additions are ready to elevate your user interfaces and streamline workflows. Please note, while we work to bring you an enhanced iconography library, all icon contributions are paused with the exception of contributions that align to AI feature development.

June 2025 Design Asset Release

We’re excited to announce the release of nine new additions to our illustration collection, specially curated with your valuable feedback in mind! We heard your needs loud and clear, and this new set is packed with versatile, high-quality visuals designed to integrate seamlessly into your features. Thank you for helping us create design assets that truly serve the Canvas community!

In this release you’ll have access to new illustrations that capture the needs of our financial users, consider a global audience, and offer more practical visuals. You’ll also find a new toned-down alert empty state for situations where you want to communicate a warning without setting off a fire alarm. Designers may access these in the Canvas Assets Figma library. And, developers can access it via npm, Artifactory, or SAS (in the integration environment).

Designers please upgrade to the latest version of the Canvas Asset Figma Library; there will be no impact to existing designs or development with this release.

Canvas v13.1 Release

Canvas v13.1 is now available in Canvas Kit React and CSS!

Deprecate Themeable

Themeable has been deprecated. Use CanvasProvider with a theme object to apply theming at the root level of an application. To customize styles for a component, use CSS variables and Canvas tokens. The example here demonstrates this with Buttons.

Previously, Themeable indicated that components could be themed. As components are updated to use CSS tokens, this type is no longer necessary.

react-virtual Upgrade

react-virtual v2 has been upgraded to @tanstack/react-virtual v3. UNSTABLE_virtual now references @tanstack/react-virtual. Refer to the TanStack documentation for a complete list of available properties.

Canvas v13 Release

Canvas v13 will be released on April 23rd, 2025 with updates to Canvas Kit and the Canvas Figma libraries. An upgrade guide will be available once v13 goes live to assist product teams with upgrading to the newest version of Canvas.

The v13 release will include component promotion and refactoring, new Menu grouping and hierarchy features, and updates to the dub and logo.

Release Overview

The table below contains a high-level overview of the updates that will be rolled out as part of the v13 release. The impact for designers and developers are defined as follows:

• None: inapplicable to the role or no actions are required for users to adopt the change; Updates will be applied automatically once users upgrade to Canvas Kit v13 and/or switch to the new v13 Canvas Web Figma library
• Low: minor changes are required for users to adopt the change
• Medium: a moderate amount of changes are required for users to adopt the change, such as switching out UI elements
• High: a large amount of changes are required for users to adopt the change, requiring product teams to make major design or development decisions

Change		Designer Impact	Developer Impact
tsconfig Support for React-jsx	tsconfig will be updated to support react-jsx for React 17+, dropping support for React 16.7 and below.	None	High
External Hyperlink Styles Refactoring & i18n Enhancements	The External Hyperlink component will be updated to use the new styling utilities and tokens. Additional enhancements will also be added to promote internationalization.	None	Low
Pill Styles Refactoring & API Enhancements	The Pill component will be updated to use the new styling utilities and tokens. Its API will also be updated to provide better support for accessibility, clean up the DOM structure, and enhance its styling.	None	Low
Menu Grouping & Hierarchy Support	Grouping and hierarchy support will be added to the Menu in Main to help organize and parse data.	None	None
New Dub & Logo Promotion	The new dubs and logos released in 12.X will be promoted, fully replacing the old dubs and logos.	None	Low
Dub & Logo URL Redirects	Old instances of dub and logo URLs will be redirected to the new set of public URLs.	None	None
Avatar Default altText Removal	Removed the default altText (“Avatar”) on Avatar.	None	Low
Expandable Styles Refactor & Promotion	The Expandable component will be promoted and updated to use the new styling utilities and tokens.	None	None
Component Styles Refactor	The following Canvas components will be updated to use the new styling utilities and tokens: Action Bar, Banner, Loading Sparkles, Menu (in Main), Side Panel, Skeleton, Tabs and Tooltip.	None

Tsconfig Support for React-jsx

tsconfig will be updated to support react-jsx. This will allow Canvas to better support modern technologies like Vite and esmodules.

This update will not impact designers, but will require development teams to be on React 16.8 or higher.

External Hyperlink Styles Refactoring & i18n Enhancements

The External Hyperlink component will be refactored to use the new styling utilities and tokens, along with some enhancements to improve internationalization. iconLabel will be a required prop and the default aria-label of Opens link in the new window will also be removed. This will ensure teams pass in a valid string instead of utilizing the default english string.

This update will not impact designers. Developers must begin providing a value to iconLabel.

Pill Styles Refactoring & API Enhancements

The Pill component will be refactored to use the new styling utilities and tokens. Additionally, the following changes have been made to Pill’s API to better support accessibility, clean up the DOM structure, and enhance its styling:

• maxWidth has been removed from the usePillModel. This config was used to style sub-components. With the refactor to use data-part and stencils, it is no longer needed on the model. maxWidth can still be applied on the <Pill/> element to ensure text truncates accordingly.
• <Pill.Icon/> and <Pill.IconButton/> no longer add a default value for aria-labels. Teams must provide an aria-label to ensure proper accessibility. Canvas examples have been updated to reflect this change.
• Pill.Label/> is a required element when using other sub-components like <Pill.Icon/> to ensure that the label truncates correctly.

This update will not impact designers.

Developers should provide an aria-label for <Pill.Icon/> and <Pill.IconButton/>, and utilize Pill.Label/> for sub-components.

Menu Grouping & Hierarchy Support

New grouping and hierarchy functionality will be added to the Menu in Main. This will enable teams to organize Menu items, making it easier for users to parse through the contents of a Menu.

This is a net-new feature and no action will be required from designers or developers to uptake this change.

New Dub & Logo Promotion

The new Dubs and Logos released in v12.2.0 will be promoted from Preview to Main. A codemod will be provided to assist with this promotion. The codemod will update the name of the logo in the import statement and the name of the logo being used in a JSX Element.

Dub & Logo URL Redirects

The legacy public Dub and Logo URLs coming from design.workday.com will be redirected to the new set of URLs from static.workday.com. These redirects will stay in place until October, 2025.

This will not impact designers, but developers should begin swapping over to the new set of URLs from static.workday.com ahead of the redirect expiration date.

Avatar

The Avatar component’s default altText has been removed for better internalization. The default was an English word (“Avatar”) and this has caused issues in the past with translations.

This update will not impact designers, but will require development teams to add altText to their Avatar component if they were relying on the default prior.

Expandable Styles Refactor & Promotion

The Expandable component will be promoted to the Main package and refactored to use the new styling utilities and tokens. The API will remain unchanged, preserving its behavior and functionality. A codemod will also be available to help assist teams with uptaking the change.

This update will not impact developers or designers.

Additional Component Styles Refactor

The following components will be refactored to use the new styling utilities and tokens as part of the work to migrate over to a singular token set:

• Action Bar
• Banner
• Loading Sparkles
• Menu (in Main)
• Side Panel
• Skeleton
• Tabs
• Tooltip

Their APIs will remain unchanged, preserving its behavior and functionality. As part of this refactoring work, small design changes may occur. The most noticeable change will occur with Tabs, whose disabled icon color has been updated to use system.color.fg.disabled, making the icon darker for better contrast.

This update will not impact developers or designers.

Canvas Mobile April Release

In 2025, Canvas Mobile will deliver releases on a biannual cadence - this month marks the first of two biannual major releases. In this Canvas Mobile release, designers and developers have access to new and updated design guidance for Webview, Hubs Framework, Card Framework, and Tourtip. It also includes new components such as Loading Dots.

A major highlight also includes the deprecation of the Canvas Mobile Beta Library. All tooling will be merged into one primary library and can be accessed in the Canvas Mobile Figma Library.

Check out what’s available for you to start using today in Canvas for Mobile!

Release Overview

In this release, we’re excited to highlight Webview and specific guidance for Mobile teams leveraging Webview for new feature development; be sure to review our best practices for using this methodology. Additionally, view the newest components and enhancements in the table below. There is no retroactive impact for developers and designers. If you need support, visit #ask-canvas-mobile.

Change	Description
New Mobile Components and Enhancements	Loading Dots are now included in the Canvas Mobile Figma Library alongside enhancements to Empty State (formerly Full Page Errors), and Tourtip.
New User Guidance for Frameworks	New guidance for Card Framework, Hubs Framework, and Webview is available.

New Mobile Components and Enhancements

New Components

• Loading Dots (iOS, Android): in place of the Bouncy Cloud, Loading Dots can be used to imply page transitions making users aware that content is loading or that a change will display soon on the page.

Enhancements:

• Empty State (iOS, Android): formerly Full Page Errors, Empty States are configurable full page and bottom sheet screens for displaying system errors or communicating to users when there is no data to display. Newly branded Workday illustrations are available in the component in code and previewed in documentation.
• Tourtip (iOS, Android): formerly Quick Tips, Tourtips are popups that succinctly educate users about functionality.

New User Guidance for Frameworks

Check out new and updated design documentation for Card Framework and Hubs Framework.

Webview

As Workday begins to scale mobile usage for users, teams are increasingly applying Webview to release features that are compatible with mobile platforms. For additional context on when and how to best use Webview for new feature development, please apply Canvas Mobile’s design guidance for best practices.

Previous Releases

• Canvas v12 Announcements
• Canvas v11 Announcements
• Canvas v10 Announcements
• Canvas v9 Announcements
• Canvas v8 Announcements
• Canvas v7 Announcements
• Canvas v6 Announcements