diff --git a/docs/mini-apps/quickstart/migrate-existing-apps.mdx b/docs/mini-apps/quickstart/migrate-existing-apps.mdx
index e2b3d2c1b..44bd79e43 100644
--- a/docs/mini-apps/quickstart/migrate-existing-apps.mdx
+++ b/docs/mini-apps/quickstart/migrate-existing-apps.mdx
@@ -18,6 +18,10 @@ description: Quickly migrate your existing app to a mini app, preview it in Base
 * You have an existing web app 
 * You have a Base app account
 
+<Warning>
+This guide is for apps that still need the manifest-based Mini App flow. If your app is already registered on Base.dev and you are following the standard web app path, start with [Migrate to a Standard Web App](/mini-apps/quickstart/migrate-to-standard-web-app) first. That path does not require a Farcaster manifest for standard web app support in the Base App.
+</Warning>
+
 
 <Steps>
 <Step title="Add the MiniApp SDK">
@@ -238,4 +242,3 @@ The `accountAssociation` fields in the manifest are used to verify ownership of
     />
 </Step>
 </Steps>
-
diff --git a/docs/mini-apps/quickstart/migrate-to-standard-web-app.mdx b/docs/mini-apps/quickstart/migrate-to-standard-web-app.mdx
index 0c8e5ca68..fb7a769c1 100644
--- a/docs/mini-apps/quickstart/migrate-to-standard-web-app.mdx
+++ b/docs/mini-apps/quickstart/migrate-to-standard-web-app.mdx
@@ -8,6 +8,10 @@ tag: "NEW"
 After April 9, 2026, the Base App treats all apps as standard web apps regardless of Farcaster manifests. Use the migration paths below to get your app working correctly in the Base App.
 </Warning>
 
+<Tip>
+If your app is already registered on Base.dev and works as a standard web app in the Base App, use this guide as your primary path. You do not need to go through the older "Import Mini App" flow unless you specifically need manifest-based Mini App features that still depend on `/.well-known/farcaster.json`.
+</Tip>
+
 <Tip>
 **Using an AI coding agent?** Install the [Migration Skill](https://github.com/base/skills) to let your agent handle this migration automatically. Run `npx skills add base/skills` and ask your agent to migrate your Farcaster mini app to a standard web app.
 </Tip>