diff --git a/apps/docs/content/components/layout/Inline.mdx b/apps/docs/content/components/layout/Inline.mdx
index a93d5ecdd..182d534ff 100644
--- a/apps/docs/content/components/layout/Inline.mdx
+++ b/apps/docs/content/components/layout/Inline.mdx
@@ -63,3 +63,7 @@ Inline items can be aligned on the vertical axis.
 
     TODO: Example of creating a custom version of this component
 </FeatureFlag>
+
+## Migration Notes
+
+<MigrateGuide src="layout/docs/inline/migration-notes" />
diff --git a/apps/docs/content/components/layout/Stack.mdx b/apps/docs/content/components/layout/Stack.mdx
index 15607de1e..4b38a4a3c 100644
--- a/apps/docs/content/components/layout/Stack.mdx
+++ b/apps/docs/content/components/layout/Stack.mdx
@@ -63,3 +63,7 @@ Stack items can be aligned on the vertical axis.
 
     TODO: Example of creating a custom version of this component
 </FeatureFlag>
+
+## Migration Notes
+
+<MigrateGuide src="layout/docs/stack/migration-notes" />
diff --git a/packages/components/src/layout/docs/inline/migration-notes.md b/packages/components/src/layout/docs/inline/migration-notes.md
new file mode 100644
index 000000000..17de8f86c
--- /dev/null
+++ b/packages/components/src/layout/docs/inline/migration-notes.md
@@ -0,0 +1,3 @@
+Coming from Orbiter, you should be aware of the following change:
+
+- The default `gap` value has been reduced to `1rem` / `var(--hop-space-inline-md)` from `1.25rem`. Use `UNSAFE_gap="1.25rem"` as a temporary measure during the migration to the Hopper design system. This value should eventually be removed to align with the new design standards.
diff --git a/packages/components/src/layout/docs/stack/migration-notes.md b/packages/components/src/layout/docs/stack/migration-notes.md
new file mode 100644
index 000000000..9c8979d0c
--- /dev/null
+++ b/packages/components/src/layout/docs/stack/migration-notes.md
@@ -0,0 +1,3 @@
+Coming from Orbiter, you should be aware of the following change:
+
+- The default `gap` value has been reduced to `1rem` / `var(--hop-space-stack-md)` from `1.25rem`. Use `UNSAFE_gap="1.25rem"` as a temporary measure during the migration to the Hopper design system. This value should eventually be removed to align with the new design standards.