diff --git a/docs/pages/blog/migration-update.js b/docs/pages/blog/mui-core-v5-migration-update.js
similarity index 71%
rename from docs/pages/blog/migration-update.js
rename to docs/pages/blog/mui-core-v5-migration-update.js
index 8a06069919e9df..1fccf9b5f55d52 100644
--- a/docs/pages/blog/migration-update.js
+++ b/docs/pages/blog/mui-core-v5-migration-update.js
@@ -1,6 +1,6 @@
import * as React from 'react';
import TopLayoutBlog from 'docs/src/modules/components/TopLayoutBlog';
-import { docs } from './migration-update.md?@mui/markdown';
+import { docs } from './mui-core-v5-migration-update.md?@mui/markdown';
export default function Page() {
return ;
diff --git a/docs/pages/blog/migration-update.md b/docs/pages/blog/mui-core-v5-migration-update.md
similarity index 79%
rename from docs/pages/blog/migration-update.md
rename to docs/pages/blog/mui-core-v5-migration-update.md
index de1d410000d2fc..058e2bc741a750 100644
--- a/docs/pages/blog/migration-update.md
+++ b/docs/pages/blog/mui-core-v5-migration-update.md
@@ -1,7 +1,7 @@
---
title: Why you should migrate to Material UI v5 today
description: We have completely revamped our Migration guide to reduce friction when upgrading to v5. Get started now!
-date: 2022-06-15T00:00:00.000Z
+date: 2022-06-20T00:00:00.000Z
authors: ['samuelsycamore']
card: true
tags: ['MUI Core']
@@ -17,10 +17,10 @@ This is exciting for us, because we're super proud of all the improvements that
But it seems as though a fair share of users are still hesitant to make the jump.
This could be because v5 contains many breaking changes from v4, so the migration can be a large undertaking.
-That's why we've completely revamped our [v4 -> v5 migration guide](https://mui.com/material-ui/migration/migration-v4/)—to help reduce the amount of friction you might encounter when updating to v5.
+That's why we've completely revamped our [v4 -> v5 migration guide](/material-ui/migration/migration-v4/)—to help reduce the amount of friction you might encounter when updating to v5.
We hope it helps!
-Be sure to check out [the updated migration guide](https://mui.com/material-ui/migration/migration-v4/) in the Material UI docs.
+Be sure to check out [the updated migration guide](/material-ui/migration/migration-v4/) in the Material UI docs.
## Why you should upgrade to v5
@@ -38,9 +38,16 @@ This offers significant advancements in performance when it comes to dynamic sty
Emotion unlocks many new customization options that developers had been requesting for years, such as custom style utility props, color variants, and custom theme variants.
Check out [this RFC on GitHub](https://github.com/mui/material-ui/issues/22342) for details about this change.
-
+
+
+ 
+
+
-Keep in mind that the new style engine is 100% incrementally adoptable: you can use JSS and Emotion together in the same app while migrating your components over.
+Keep in mind that the new style engine is 100% [incrementally adoptable](/material-ui/migration/migrating-from-jss/): you can use JSS and Emotion together in the same app while migrating your components over.
### 3. Better customization tools
@@ -74,7 +81,7 @@ export default function BoxSx() {
All prop descriptions are now written in TypeScript, which means that you can access details about the usage of a given prop right inside of your IDE—no need to seek out the official documentation to find this information.
-
+
### 5. Upcoming CSS variables support
@@ -87,6 +94,6 @@ You can check out the progress on this effort [in this GitHub issue](https://git
## Upgrade now
What are you waiting for?
-Jump into the [newly revised migration documention](https://mui.com/material-ui/migration/migration-v4/) and get started today.
+Jump into the [newly revised migration documention](/material-ui/migration/migration-v4/) and get started today.
Let us know if you have any questions along the way!
diff --git a/docs/public/static/blog/migration-update/intellisense-tooltip.png b/docs/public/static/blog/migration-update/intellisense-tooltip.png
deleted file mode 100644
index fdd0b988974476..00000000000000
Binary files a/docs/public/static/blog/migration-update/intellisense-tooltip.png and /dev/null differ
diff --git a/docs/public/static/blog/migration-update/style-engine.png b/docs/public/static/blog/migration-update/style-engine.png
deleted file mode 100644
index 7d300de57853d1..00000000000000
Binary files a/docs/public/static/blog/migration-update/style-engine.png and /dev/null differ
diff --git a/docs/public/static/blog/migration-update/card.png b/docs/public/static/blog/mui-core-v5-migration-update/card.png
similarity index 100%
rename from docs/public/static/blog/migration-update/card.png
rename to docs/public/static/blog/mui-core-v5-migration-update/card.png
diff --git a/docs/public/static/blog/mui-core-v5-migration-update/intellisense-tooltip.png b/docs/public/static/blog/mui-core-v5-migration-update/intellisense-tooltip.png
new file mode 100644
index 00000000000000..37728851d53f40
Binary files /dev/null and b/docs/public/static/blog/mui-core-v5-migration-update/intellisense-tooltip.png differ
diff --git a/docs/public/static/blog/mui-core-v5-migration-update/style-engine.png b/docs/public/static/blog/mui-core-v5-migration-update/style-engine.png
new file mode 100644
index 00000000000000..e736cc87af5177
Binary files /dev/null and b/docs/public/static/blog/mui-core-v5-migration-update/style-engine.png differ