diff --git a/CHANGELOG.md b/CHANGELOG.md
index ef565edfdbb92..738e0120b4dc6 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -40,8 +40,8 @@ Same changes as in `@mui/x-data-grid-pro@9.0.0-rc.0`, plus:
#### Breaking changes
-- Accessible DOM structure is now the only default. [Read more](https://mui.com/x/migration/migration-pickers-v8/#accessible-dom-structure-is-now-the-default)
-- The `PickerDay2` and `DateRangePickerDay2` components were propagated to stable while removing the previous defaults. [Read more](https://mui.com/x/migration/migration-pickers-v8/#day-slot)
+- Accessible DOM structure is now the only default. [Read more](https://mui.com/x/migration/upgrade-pickers-to-v9/#accessible-dom-structure-is-now-the-default)
+- The `PickerDay2` and `DateRangePickerDay2` components were propagated to stable while removing the previous defaults. [Read more](https://mui.com/x/migration/upgrade-pickers-to-v9/#day-slot)
#### `@mui/x-date-pickers@9.0.0-rc.0`
diff --git a/docs/data/date-pickers/custom-components/custom-components.md b/docs/data/date-pickers/custom-components/custom-components.md
index 6b38039748f5e..85ab2243dbb83 100644
--- a/docs/data/date-pickers/custom-components/custom-components.md
+++ b/docs/data/date-pickers/custom-components/custom-components.md
@@ -227,7 +227,7 @@ This change brings several benefits:
However, this might affect your custom styles if you were targeting the nested elements.
For example, in `DateRangePickerDay`, the `day` class has been removed because there is no longer a separate element for the day content.
-For more details on how to adapt your custom styles, check the [Day slot migration guide](/x/migration/migration-pickers-v8/#day-slot).
+For more details on how to adapt your custom styles, check the [Day slot migration guide](/x/migration/upgrade-pickers-to-v9/#day-slot).
### Examples
diff --git a/docs/data/migration/migration-charts-v8/migration-charts-v8.md b/docs/data/migration/upgrade-charts-to-v9/upgrade-charts-to-v9.md
similarity index 99%
rename from docs/data/migration/migration-charts-v8/migration-charts-v8.md
rename to docs/data/migration/upgrade-charts-to-v9/upgrade-charts-to-v9.md
index 39c9c8ab1345f..121654b3540b1 100644
--- a/docs/data/migration/migration-charts-v8/migration-charts-v8.md
+++ b/docs/data/migration/upgrade-charts-to-v9/upgrade-charts-to-v9.md
@@ -14,7 +14,7 @@ This is a reference guide for upgrading `@mui/x-charts` from v8 to v9.
:::success
-This guide is also available in Markdown format to be referenced by AI tools like Copilot or Cursor to help you with the migration.
+This guide is also available in Markdown format to be referenced by AI tools like Copilot or Cursor to help you with the migration.
:::
## Prepare for the migration
diff --git a/docs/data/migration/migration-data-grid-v8/migration-data-grid-v8.md b/docs/data/migration/upgrade-data-grid-to-v9/upgrade-data-grid-to-v9.md
similarity index 92%
rename from docs/data/migration/migration-data-grid-v8/migration-data-grid-v8.md
rename to docs/data/migration/upgrade-data-grid-to-v9/upgrade-data-grid-to-v9.md
index 2805d93d17ce3..46293cf2546be 100644
--- a/docs/data/migration/migration-data-grid-v8/migration-data-grid-v8.md
+++ b/docs/data/migration/upgrade-data-grid-to-v9/upgrade-data-grid-to-v9.md
@@ -12,7 +12,7 @@ productId: x-data-grid
This is a reference guide for upgrading `@mui/x-data-grid` from v8 to v9.
:::success
-This guide is also available in Markdown format to be referenced by AI tools like Copilot or Cursor to help you with the migration.
+This guide is also available in Markdown format to be referenced by AI tools like Copilot or Cursor to help you with the migration.
:::
## Start using the new release
diff --git a/docs/data/migration/migration-pickers-v8/migration-pickers-v8.md b/docs/data/migration/upgrade-pickers-to-v9/upgrade-pickers-to-v9.md
similarity index 100%
rename from docs/data/migration/migration-pickers-v8/migration-pickers-v8.md
rename to docs/data/migration/upgrade-pickers-to-v9/upgrade-pickers-to-v9.md
diff --git a/docs/data/migration/migration-tree-view-v8/migration-tree-view-v8.md b/docs/data/migration/upgrade-tree-view-to-v9/upgrade-tree-view-to-v9.md
similarity index 100%
rename from docs/data/migration/migration-tree-view-v8/migration-tree-view-v8.md
rename to docs/data/migration/upgrade-tree-view-to-v9/upgrade-tree-view-to-v9.md
diff --git a/docs/data/pages.ts b/docs/data/pages.ts
index 47f6f0e1ce5a0..dce207a103b9d 100644
--- a/docs/data/pages.ts
+++ b/docs/data/pages.ts
@@ -864,17 +864,20 @@ const pages: MuiPage[] = [
pathname: '/x/migration-v9',
subheader: 'Upgrade to v9',
children: [
- { pathname: '/x/migration/migration-data-grid-v8', title: 'Breaking changes: Data Grid' },
{
- pathname: '/x/migration/migration-pickers-v8',
+ pathname: '/x/migration/upgrade-data-grid-to-v9',
+ title: 'Breaking changes: Data Grid',
+ },
+ {
+ pathname: '/x/migration/upgrade-pickers-to-v9',
title: 'Breaking changes: Date and Time Pickers',
},
{
- pathname: '/x/migration/migration-charts-v8',
+ pathname: '/x/migration/upgrade-charts-to-v9',
title: 'Breaking changes: Charts',
},
{
- pathname: '/x/migration/migration-tree-view-v8',
+ pathname: '/x/migration/upgrade-tree-view-to-v9',
title: 'Breaking changes: Tree View',
},
],
diff --git a/docs/pages/x/migration/migration-pickers-v8.js b/docs/pages/x/migration/upgrade-charts-to-v9.js
similarity index 57%
rename from docs/pages/x/migration/migration-pickers-v8.js
rename to docs/pages/x/migration/upgrade-charts-to-v9.js
index f980319a220e4..9755fbd5709b2 100644
--- a/docs/pages/x/migration/migration-pickers-v8.js
+++ b/docs/pages/x/migration/upgrade-charts-to-v9.js
@@ -1,5 +1,5 @@
import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs';
-import * as pageProps from 'docsx/data/migration/migration-pickers-v8/migration-pickers-v8.md?muiMarkdown';
+import * as pageProps from 'docsx/data/migration/upgrade-charts-to-v9/upgrade-charts-to-v9.md?muiMarkdown';
export default function Page() {
return ;
diff --git a/docs/pages/x/migration/migration-tree-view-v8.js b/docs/pages/x/migration/upgrade-data-grid-to-v9.js
similarity index 56%
rename from docs/pages/x/migration/migration-tree-view-v8.js
rename to docs/pages/x/migration/upgrade-data-grid-to-v9.js
index 07337ceccde6d..679d842ca2f31 100644
--- a/docs/pages/x/migration/migration-tree-view-v8.js
+++ b/docs/pages/x/migration/upgrade-data-grid-to-v9.js
@@ -1,5 +1,5 @@
import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs';
-import * as pageProps from 'docsx/data/migration/migration-tree-view-v8/migration-tree-view-v8.md?muiMarkdown';
+import * as pageProps from 'docsx/data/migration/upgrade-data-grid-to-v9/upgrade-data-grid-to-v9.md?muiMarkdown';
export default function Page() {
return ;
diff --git a/docs/pages/x/migration/migration-charts-v8.js b/docs/pages/x/migration/upgrade-pickers-to-v9.js
similarity index 57%
rename from docs/pages/x/migration/migration-charts-v8.js
rename to docs/pages/x/migration/upgrade-pickers-to-v9.js
index e69548a9898b9..e8de2568bc5b1 100644
--- a/docs/pages/x/migration/migration-charts-v8.js
+++ b/docs/pages/x/migration/upgrade-pickers-to-v9.js
@@ -1,5 +1,5 @@
import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs';
-import * as pageProps from 'docsx/data/migration/migration-charts-v8/migration-charts-v8.md?muiMarkdown';
+import * as pageProps from 'docsx/data/migration/upgrade-pickers-to-v9/upgrade-pickers-to-v9.md?muiMarkdown';
export default function Page() {
return ;
diff --git a/docs/pages/x/migration/migration-data-grid-v8.js b/docs/pages/x/migration/upgrade-tree-view-to-v9.js
similarity index 56%
rename from docs/pages/x/migration/migration-data-grid-v8.js
rename to docs/pages/x/migration/upgrade-tree-view-to-v9.js
index 1bf87ea719137..83c51b1d9d2e3 100644
--- a/docs/pages/x/migration/migration-data-grid-v8.js
+++ b/docs/pages/x/migration/upgrade-tree-view-to-v9.js
@@ -1,5 +1,5 @@
import MarkdownDocs from 'docs/src/modules/components/MarkdownDocs';
-import * as pageProps from 'docsx/data/migration/migration-data-grid-v8/migration-data-grid-v8.md?muiMarkdown';
+import * as pageProps from 'docsx/data/migration/upgrade-tree-view-to-v9/upgrade-tree-view-to-v9.md?muiMarkdown';
export default function Page() {
return ;
diff --git a/docs/public/_redirects b/docs/public/_redirects
index 8b1dc6d3d0c5c..f7c325d8eff7c 100644
--- a/docs/public/_redirects
+++ b/docs/public/_redirects
@@ -79,4 +79,8 @@
/x/api/charts/chart-data-provider/ /x/api/charts/charts-data-provider/ 301
/x/api/charts/chart-data-provider-pro/ /x/api/charts/charts-data-provider-pro/ 301
/x/api/charts/chart-data-provider-premium/ /x/api/charts/charts-data-provider-premium/ 301
+/x/migration/migration-data-grid-v8 /x/migration/upgrade-data-grid-to-v9/ 301
+/x/migration/migration-pickers-v8 /x/migration/upgrade-pickers-to-v9/ 301
+/x/migration/migration-charts-v8 /x/migration/upgrade-charts-to-v9/ 301
+/x/migration/migration-tree-view-v8 /x/migration/upgrade-tree-view-to-v9/ 301
# Proxies
diff --git a/packages/x-date-pickers/src/internals/components/PickerFieldUI.tsx b/packages/x-date-pickers/src/internals/components/PickerFieldUI.tsx
index ddc851b91a8db..4ef12b3470467 100644
--- a/packages/x-date-pickers/src/internals/components/PickerFieldUI.tsx
+++ b/packages/x-date-pickers/src/internals/components/PickerFieldUI.tsx
@@ -62,7 +62,7 @@ export const cleanFieldResponse = <
'MUI X: The `InputProps`, `inputProps`, `InputLabelProps` and `FormHelperTextProps` props are no longer supported on Picker / Field components.',
'They have been silently dropped because they would otherwise be forwarded as unknown attributes on the underlying form control.',
'Use the `slotProps` shape instead (`slotProps.input`, `slotProps.htmlInput`, `slotProps.inputLabel`, `slotProps.formHelperText`).',
- 'See https://mui.com/x/migration/migration-pickers-v8/#textfield-props for migration details.',
+ 'See https://mui.com/x/migration/upgrade-pickers-to-v9/#textfield-props for migration details.',
]);
}
}
diff --git a/packages/x-date-pickers/src/internals/hooks/useField/useField.ts b/packages/x-date-pickers/src/internals/hooks/useField/useField.ts
index 00ae27207a1c0..402162ae2cc4b 100644
--- a/packages/x-date-pickers/src/internals/hooks/useField/useField.ts
+++ b/packages/x-date-pickers/src/internals/hooks/useField/useField.ts
@@ -48,7 +48,7 @@ export const useField = <
'MUI X: The `enableAccessibleFieldDOMStructure` prop has been removed.',
'The accessible DOM structure is now the default and only option.',
'You can safely remove the prop from your code.',
- 'For more information, please have a look at the migration guide (https://mui.com/x/migration/migration-pickers-v8/).',
+ 'For more information, please have a look at the migration guide (https://mui.com/x/migration/upgrade-pickers-to-v9/).',
]);
}
}
diff --git a/scripts/buildApiDocs/chartsSettings/index.ts b/scripts/buildApiDocs/chartsSettings/index.ts
index 5fd972a47c0f3..85fa742f71878 100644
--- a/scripts/buildApiDocs/chartsSettings/index.ts
+++ b/scripts/buildApiDocs/chartsSettings/index.ts
@@ -137,8 +137,7 @@ export default chartsApiPages;
isGlobalClassName: isGlobalState,
nonComponentFolders: [
...getNonComponentFolders(),
- 'migration/migration-charts-v9',
- 'migration/migration-charts-v8',
+ 'migration/upgrade-charts-to-v9',
'migration/migration-charts-v7',
'migration/migration-charts-v6',
],
diff --git a/scripts/buildApiDocs/gridSettings/index.ts b/scripts/buildApiDocs/gridSettings/index.ts
index 62b30b802b70e..fae66ba398138 100644
--- a/scripts/buildApiDocs/gridSettings/index.ts
+++ b/scripts/buildApiDocs/gridSettings/index.ts
@@ -118,7 +118,7 @@ export default dataGridApiPages;
nonComponentFolders: [
...getNonComponentFolders(),
'data-grid/components/usage.md',
- 'migration/migration-data-grid-v8',
+ 'migration/upgrade-data-grid-to-v9',
'migration/migration-data-grid-v7',
'migration/migration-data-grid-v6',
'migration/migration-data-grid-v5',
diff --git a/scripts/buildApiDocs/treeViewSettings/index.ts b/scripts/buildApiDocs/treeViewSettings/index.ts
index 4e5ed92a02ba9..adbd98ec09099 100644
--- a/scripts/buildApiDocs/treeViewSettings/index.ts
+++ b/scripts/buildApiDocs/treeViewSettings/index.ts
@@ -85,7 +85,7 @@ export default treeViewApiPages;
isGlobalClassName: isGlobalState,
nonComponentFolders: [
...getNonComponentFolders(),
- 'migration/migration-tree-view-v8',
+ 'migration/upgrade-tree-view-to-v9',
'migration/migration-tree-view-v7',
'migration/migration-tree-view-v6',
'migration/migration-tree-view-lab',