Tag margin removed in v6
v6 removes the default margin-inline-end from the Tag component that existed in previous versions. If layouts or custom styles depend on this behavior, use ConfigProvider's tag.styles to add it back: tag={{ styles: { root: { marginInlineEnd: 8 } } }}.
Space deprecated API changes in v6
Space component deprecated APIs: direction→orientation, split→separator.
Descriptions deprecated API changes in v6
Descriptions component deprecated APIs: children→items, labelStyle→styles.label, contentStyle→styles.content, size="default"→size="large" (v6.3.2), size="middle"→size="medium" (v6.3.2).
Transfer deprecated API changes in v6
Transfer component deprecated APIs: listStyle→styles.section, operationStyle→styles.actions, operations→actions.
Timeline deprecated API changes in v6
Timeline component deprecated APIs: Timeline.Item→items, Timeline.Item.position→placement (values left/right become start/end), Timeline.Item.label→title, Timeline.Item.children→content, Timeline.Item.dot→icon, pending→items, pendingDot→items, mode=left|right→mode=start|end.
Table deprecated API changes in v6
Table component deprecated APIs: pagination.position→pagination.placement, onSelectInvert→onChange, filterDropdownOpen→filterDropdownProps.open, onFilterDropdownOpenChange→filterDropdownProps.onOpenChange, filterCheckall→locale.filterCheckAll, onSelectMultiple→onChange, onSelectAll→onChange, onSelectNone→onChange.
Steps deprecated API changes in v6
Steps component deprecated APIs: labelPlacement→titlePlacement, progressDot→type="dot", direction→orientation, items.description→items.content, size="default"→size="medium" (v6.3.2).
Statistic deprecated API changes in v6
Statistic component: valueStyle is deprecated, use styles.content instead.
Splitter deprecated API changes in v6
Splitter component: layout is deprecated, use orientation instead. collapsibleIcon is deprecated (v6.4.0), use collapsible.icon instead.
Modal and Drawer mask blur behavior in v6
Modal and Drawer components have new mask layer functionality with blur effect support. From v6.0.0 to v6.2.x, blur was enabled by default. Starting from v6.3.0, blur is disabled by default. To enable blur, configure it via ConfigProvider with modal={{ mask: { blur: true } }} and drawer={{ mask: { blur: true } }}.
Spin deprecated API changes in v6
Spin component: tip is deprecated, use description instead (v6.3.0). wrapperClassName→classNames.root. size="default"→size="medium" (v6.3.2).
Browser support in v6
v6 only supports modern browsers and uses CSS variables by default. Internet Explorer is no longer supported.
DOM structure changes in v6
v6 upgrades and optimizes the DOM structure of many components. Projects that rely on custom styles targeting internal DOM nodes of components may need to inspect and adjust those styles after upgrading.
v6 upgrade checklist
To ensure app works correctly after upgrading to v6: (1) Confirm app uses React >= 18 and has removed @ant-design/v5-patch-for-react-19. (2) Confirm @ant-design/icons upgraded to >= 6.0.0 to match antd@6. (3) Confirm target user browsers are modern and support CSS variables. (4) If using CSS targeting component internal DOM nodes, verify and adjust if necessary. (5) Decide whether Modal, Drawer, etc. need mask blur disabled. (6) Ensure build completes without errors and CSS variables / CSS-in-JS work correctly. (7) Run app and resolve any legacy API warnings in console.
Pre-upgrade checklist before v5 to v6 migration
Before upgrading to v6: (1) First upgrade to the latest v5 release and address any deprecation warnings shown in the console. (2) Make sure your project runs on React 18 or above. (3) Verify that modern browsers are supported and CSS variables are compatible.
v6 removes @ant-design/v5-patch-for-react-19
You no longer need the @ant-design/v5-patch-for-react-19 package in v6 to support React 19 and should remove it if present.
@ant-design/icons version requirement for antd v6
antd v6 requires @ant-design/icons version >= 6.0.0. @ant-design/icons@6 is not compatible with antd@5, so both packages must be upgraded together.
React version requirement for antd v6
antd v6 requires React >= 18 and no longer supports React 17 or earlier.
Recommended products for developers, designers, and product managers
Ant Design recommends several products for teams: Documentation (Yuque); Icon (Iconfont); Sketch plugin (Kitchen); Online Playground (codesandbox, codepen); Image Compressor (tinypng).
Ant Design scope and complementary libraries
Ant Design is built to implement a set of high-quality React UI components following the Ant Design specification. It is impossible to include all useful components in one package, so the Ant Design team recommends using other great third-party libraries in the React community to supplement Ant Design's component set.
Recommended third-party libraries for React with Ant Design
Ant Design recommends integrating with third-party libraries across multiple categories: Visualization and charts (Ant Design Charts, AntV Data Visualization, reactflow); React Hooks Library (ahooks); React Form Library (ProForm, Formily, react-hook-form, formik); Router (react-router); Layout (react-grid-layout, react-grid-system, rc-dock); Drag and drop (dnd-kit, react-beautiful-dnd, react-dnd); Code Editor (react-codemirror2, react-monaco-editor); Rich Text Editor (react-quill); JSON Viewer (react-json-view); Color Picker (react-colorful, react-color); Media Query (react-responsive); Copy to clipboard (react-copy-to-clipboard); Document head manager (react-helmet-async); Icons (react-fontawesome, react-icons); QR Code (qrcode.react); Top Progress Bar (react-nprogress); i18n (FormatJS, react-i18next); Code highlight (react-syntax-highlighter); Markdown renderer (react-markdown); Infinite Scroll (@rc-component/virtual-list, react-infinite-scroll-component); Map (google-map-react, @uiw/react-amap); Video (react-player, video-react, video.js); Context Menu (react-contexify); Emoji (emoji-picker-react, emoji-mart); Split View (react-split-pane, react-resizable-panels); Image Crop (antd-img-crop, react-image-crop); Keywords highlight (react-highlight-words); Text Loop (react-text-loop-next, react-fast-marquee); Animation (motion, Ant Motion, react-spring); Page Footer (rc-footer); Number/Currency (react-countup, react-number-format, react-currency-input-field); Application Frameworks (umi, remix, refine); Flow-based UI (pro-flow, react-flow, x6); Phone Input (react-phone-number-input, antd-phone-input); AI Chat (Ant Design X); CLI Tool (Ant Design CLI); PDF (react-pdf, @react-pdf/renderer); React Gesture (use-gesture).
Server-side rendering whole export mode advantages and disadvantages
Whole export mode pre-bakes the antd component as a CSS file to be introduced in the page. The advantage is that when opening any page, the same set of CSS files will be reused just like the traditional CSS scheme to hit the cache. The disadvantage is that if there are multiple themes in the page, additional baking is required.
Server-side rendering inline mode advantages and disadvantages
Inline mode embeds styles directly into the HTML during rendering without requiring additional style file requests. The advantage is that it reduces additional network requests. The disadvantage is that the HTML volume will increase and the speed of the first screen rendering will be affected.
tsconfig.node.json configuration for SSR CSS generation
For running TypeScript SSR scripts, create tsconfig.node.json with strictNullChecks enabled, module set to NodeNext, jsx set to react, esModuleInterop enabled, and include pattern for 'next-env.d.ts', '**/*.ts', and '**/*.tsx'.
On-demand CSS extraction example with Next.js Document
In Next.js, implement on-demand CSS extraction in _document.tsx by creating a cache, passing it to StyleProvider in renderPage enhancer, then calling doExtraStyle(cache) in getInitialProps to extract used styles. Inject the returned filename as a stylesheet link in the document head.
Whole export CSS generation with @ant-design/static-style-extract
To generate a complete antd CSS file, use @ant-design/static-style-extract package. Call extractStyle() to generate full CSS and write it to a file using fs.writeFileSync(). This CSS file can then be imported in your application.
Recommended image crop libraries
For image cropping functionality, the recommended libraries are: antd-img-crop and react-image-crop.
Recommended emoji picker libraries
For emoji selection, the recommended libraries are: emoji-picker-react and emoji-mart.
Recommended context menu library
The recommended context menu (right-click menu) library is react-contexify.
Recommended video player libraries
For video playback, the recommended libraries are: react-player, video-react, and video.js.
Recommended map libraries
For map integration, the recommended libraries are: google-map-react and @uiw/react-amap for Amap (Aladdin Maps).
Recommended infinite scroll libraries
For infinite scroll functionality, the recommended libraries are: @rc-component/virtual-list and react-infinite-scroll-component.
Recommended Markdown rendering library
The recommended library for rendering Markdown is react-markdown.
Recommended code syntax highlighting library
The recommended library for code syntax highlighting is react-syntax-highlighter.
Recommended top progress bar library
The recommended library for top progress bars is react-nprogress.
Recommended QR code library
The recommended QR code library is qrcode.react.
Recommended icon libraries
For icon display, the recommended libraries are: react-fontawesome and react-icons.
Recommended clipboard copy library
The recommended library for copying to clipboard is react-copy-to-clipboard.
Recommended responsive design library
The recommended library for responsive design detection is react-responsive.
Recommended color picker libraries
For color picking functionality, the recommended libraries are: react-colorful and react-color.
Recommended JSON display library
The recommended JSON display library is react-json-view.
Recommended JSON editor library
The recommended JSON editor library is vanilla-jsoneditor.
Recommended rich text editor library
The recommended rich text editor library is react-quill.
Recommended code editor libraries
For code editors, the recommended libraries are: @uiw/react-codemirror and react-monaco-editor.
Recommended drag and drop libraries
For drag and drop functionality, the recommended libraries are: dnd-kit, react-beautiful-dnd, and react-dnd.
Recommended page meta tags library
The recommended library for managing page meta tags is react-helmet-async.
Recommended layout libraries
For layout systems, the recommended libraries are: react-grid-layout, react-grid-system, and rc-dock.
Recommended routing library
The recommended routing library is react-router.
Recommended form libraries
For form handling beyond Ant Design components, the recommended libraries are: ProForm, Formily, react-hook-form, and formik.
Recommended internationalization libraries
For application internationalization, the recommended libraries are: FormatJS and react-i18next.
Recommended React Hooks library
The recommended React Hooks library to use with Ant Design is ahooks.
Recommended visualization chart libraries
For visualization and charts, the recommended libraries are: Ant Design Charts, AntV data visualization solution, and reactflow.
Ant Design scope and complementary libraries
Ant Design (antd) is a high-quality React component library implementing the Ant Design specification. It provides only UI components that follow the specification with visual presentation, and does not duplicate existing solutions. The documentation recommends using complementary community libraries to extend its functionality.
Recommended text loop/marquee libraries
For text looping and marquee effects, the recommended libraries are: react-text-loop-next and react-fast-marquee.
Recommended keyword highlight library
The recommended library for highlighting keywords in text is react-highlight-words.
Recommended animation libraries
For animations, the recommended libraries are: motion (Framer Motion), Ant Motion, and react-spring.
Recommended footer library
The recommended footer component library is rc-footer.
Recommended split pane libraries
For split pane layouts, the recommended libraries are: react-split-pane and react-resizable-panels.
Recommended number and currency formatting libraries
For number and currency formatting, the recommended libraries are: react-number-format and react-currency-input-field.
Recommended mobile device detection library
The recommended library for detecting mobile devices is react-device-detect.