Deprecations
Stay informed on deprecated packages and assets in the Carbon Design System with updates, migration guides, and resources for transitioning to the latest supported versions.
React v16 and v17
React versions 16.x and 17.x are considered deprecated for use with Carbon v11,
@carbon/react@1.x
Carbon v12,
@carbon/react@2.x
React v18 will remain a supported version in Carbon v12, but will be considered deprecated.
What to use instead
Use the latest stable version of React, v19.2 at the time of this writing.
The Carbon team recommends continually investing in your project’s toolchain. Practicing good dependency hygiene and keeping your infrastructure up to date helps create a more stable and secure environment when building with Carbon.
Migration
Refer to the official React 19 Upgrade Guide. If you’re not already on v18.3+, the react team recommends updating to that version before migrating to v19.
If updating to v18, refer to the official React 18 Upgrade Guide.
React v18 and v19 have been available for over 4 years, and 2 years, respectively.
Reconsider your React version blockers
If you attempted to update your React version between 2022-2025 and ran into blockers, those blockers should be reassessed. Agentic tooling has advanced significantly, and migrations that previously required large, sustained effort may now be far more tractable.
Carbon’s migration from Enzyme to React Testing Library, for example, took well over a year in 2022. With today’s tooling, that same type of migration could likely be completed in a couple afternoons by a strong developer working with a capable agent.
carbon-components
carbon-components
What to use instead
carbon-components
@carbon/styles
@carbon/styles
If you’re using
@carbon/react
@carbon/web-components
@carbon/styles
@carbon/styles
Library authors should use
@carbon/styles
@carbon/react
Migration
For those using
carbon-components@10.x
For those using
carbon-components@11.x
@carbon/styles
For questions regarding this deprecation or how to migrate, contact us.
carbon-components-react
carbon-components-react
What to use instead
carbon-components-react
@carbon/react
Migration
For those using
carbon-components-react@7.x
For those using
carbon-components-react@8.x
@carbon/react
@carbon/react
carbon-components-react
@carbon/react
For questions regarding this deprecation or how to migrate, contact us.
v10 Elements packages
All v10 assets reached end of support on September 30, 2024, including v10.x ranges of elements packages. This includes:
- @carbon/colors@10.x
- @carbon/elements@10.x
- @carbon/grid@10.x
- @carbon/layout@10.x
- @carbon/motion@10.x
- @carbon/themes@10.x
- @carbon/type@10.x
What to use instead
The v11.x ranges of these packages should be used instead.
Migration
The v11 migration guide has all the details of how to update.
For questions regarding these deprecations or how to migrate, contact us.
carbon-icons
The
carbon-icons
What to use instead
To use icons from the Carbon Design System, you should install the appropriate library to use with your framework:
Migration
The v11 migration guide has all the details of how to update.
For questions regarding these deprecations or how to migrate, contact us.
