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 87%
rename from docs/pages/blog/migration-update.md
rename to docs/pages/blog/mui-core-v5-migration-update.md
index de1d410000d2fc..c04151a0e74268 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']
@@ -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
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