diff --git a/docs/src/documentation/05-development/04-migration-guides/01-v17.mdx b/docs/src/documentation/05-development/04-migration-guides/01-v17.mdx
new file mode 100644
index 0000000000..2d541d50b9
--- /dev/null
+++ b/docs/src/documentation/05-development/04-migration-guides/01-v17.mdx
@@ -0,0 +1,17 @@
+---
+title: v17
+description: How to migrate to Orbit 17.0.0
+redirect_from:
+  - /migration-guides/v17/
+---
+
+# Orbit Migration Guide v17
+
+This migration guide focuses on the process of migrating from Orbit v16 to v17.0, as some breaking changes were introduced.
+With this guide, we aim to walk through all the breaking changes and how they can be addressed, allowing the migration to be smoother and effortlessly.
+
+## Breaking changes
+
+### ColoredTwitter icon removed
+
+The `ColoredTwitter` icon was removed. The `Twitter` icon should be used instead.
diff --git a/docs/src/documentation/05-development/04-migration-guides/01-v16.mdx b/docs/src/documentation/05-development/04-migration-guides/02-v16.mdx
similarity index 100%
rename from docs/src/documentation/05-development/04-migration-guides/01-v16.mdx
rename to docs/src/documentation/05-development/04-migration-guides/02-v16.mdx
diff --git a/docs/src/documentation/05-development/04-migration-guides/02-v15.mdx b/docs/src/documentation/05-development/04-migration-guides/03-v15.mdx
similarity index 100%
rename from docs/src/documentation/05-development/04-migration-guides/02-v15.mdx
rename to docs/src/documentation/05-development/04-migration-guides/03-v15.mdx
diff --git a/docs/src/documentation/05-development/04-migration-guides/03-v14.mdx b/docs/src/documentation/05-development/04-migration-guides/04-v14.mdx
similarity index 100%
rename from docs/src/documentation/05-development/04-migration-guides/03-v14.mdx
rename to docs/src/documentation/05-development/04-migration-guides/04-v14.mdx
diff --git a/docs/src/documentation/05-development/04-migration-guides/04-v12.mdx b/docs/src/documentation/05-development/04-migration-guides/05-v12.mdx
similarity index 100%
rename from docs/src/documentation/05-development/04-migration-guides/04-v12.mdx
rename to docs/src/documentation/05-development/04-migration-guides/05-v12.mdx
diff --git a/docs/src/documentation/05-development/04-migration-guides/05-v11.mdx b/docs/src/documentation/05-development/04-migration-guides/06-v11.mdx
similarity index 100%
rename from docs/src/documentation/05-development/04-migration-guides/05-v11.mdx
rename to docs/src/documentation/05-development/04-migration-guides/06-v11.mdx
diff --git a/docs/src/documentation/05-development/04-migration-guides/06-v10.mdx b/docs/src/documentation/05-development/04-migration-guides/07-v10.mdx
similarity index 100%
rename from docs/src/documentation/05-development/04-migration-guides/06-v10.mdx
rename to docs/src/documentation/05-development/04-migration-guides/07-v10.mdx
diff --git a/docs/src/documentation/05-development/04-migration-guides/07-v9.mdx b/docs/src/documentation/05-development/04-migration-guides/08-v9.mdx
similarity index 100%
rename from docs/src/documentation/05-development/04-migration-guides/07-v9.mdx
rename to docs/src/documentation/05-development/04-migration-guides/08-v9.mdx
diff --git a/docs/src/documentation/05-development/04-migration-guides/08-v7.mdx b/docs/src/documentation/05-development/04-migration-guides/09-v7.mdx
similarity index 100%
rename from docs/src/documentation/05-development/04-migration-guides/08-v7.mdx
rename to docs/src/documentation/05-development/04-migration-guides/09-v7.mdx