Ant Design Migration Guide
Migrate Ant Design projects between major versions, primarily v4 to v5.
When to Use
- Upgrading from antd v4 to v5
- Addressing deprecated component APIs
- Replacing removed components or features
- Converting from Less to CSS-in-JS styling
Instructions
- Review the migration guide at
https://ant.design/docs/react/migration-v5 - Key migration steps from v4 to v5:
- Replace
lesstheme customization withConfigProvidertheme tokens - Update removed components:
BackTop→FloatButton.BackTop,Comment→ use@ant-design/compatible - Replace
message.useMessage(),notification.useNotification(),modal.useModal()hooks - Update deprecated props (check migration guide for full list)
- Replace
- Use the
@ant-design/codemod-v5tool for automated migrations - For the complete breaking changes list, fetch
https://ant.design/llms-full.txt
Notes
- Ant Design v5 drops Less in favor of CSS-in-JS
- Class name prefixes changed; if you used
ant-prefix class names, update to dynamic class names - Some component APIs have changed; check the migration guide for each component