diff --git a/src/pages/[platform]/start/migrate-to-gen2/index.mdx b/src/pages/[platform]/start/migrate-to-gen2/index.mdx
index 839c565d472..7ae94f8cfb1 100644
--- a/src/pages/[platform]/start/migrate-to-gen2/index.mdx
+++ b/src/pages/[platform]/start/migrate-to-gen2/index.mdx
@@ -34,4 +34,10 @@ export function getStaticProps(context) {
 
 Whether you're migrating an existing Gen 1 environment or exploring what's changed in Gen 2, these guides will help you navigate the transition.
 
+<Callout warning>
+
+**Gen 2 requires Amplify JavaScript v6.** Gen 2 backends are not compatible with `aws-amplify` v5. If your frontend is still on v5, you must complete the [v5 to v6 migration](/gen1/[platform]/build-a-backend/troubleshooting/migrate-from-javascript-v5-to-v6/) before proceeding with the Gen 2 migration.
+
+</Callout>
+
 <Overview childPageNodes={props.childPageNodes} />
diff --git a/src/pages/[platform]/start/migrate-to-gen2/migrate-existing-app/index.mdx b/src/pages/[platform]/start/migrate-to-gen2/migrate-existing-app/index.mdx
index c6416a439f9..673ab33c4a6 100644
--- a/src/pages/[platform]/start/migrate-to-gen2/migrate-existing-app/index.mdx
+++ b/src/pages/[platform]/start/migrate-to-gen2/migrate-existing-app/index.mdx
@@ -124,6 +124,12 @@ Before starting the migration, carefully review the [Backend Categories](/[platf
 
 ## Prerequisites
 
+<Callout warning>
+
+**Gen 2 requires Amplify JavaScript v6.** Gen 2 backends are not compatible with `aws-amplify` v5. If your frontend is still on v5, you must complete the [v5 to v6 migration](/gen1/[platform]/build-a-backend/troubleshooting/migrate-from-javascript-v5-to-v6/) before proceeding with the Gen 2 migration.
+
+</Callout>
+
 ### DataStore
 
 If your API has conflict resolution enabled (DataStore), you must disable it before proceeding with the Gen 2 migration. See the [Migrate from DataStore](/gen1/[platform]/build-a-backend/more-features/datastore/migrate-from-datastore/) guide for instructions.