diff --git a/README.md b/README.md
index f46e9ba0..ee4dd8d6 100644
--- a/README.md
+++ b/README.md
@@ -111,6 +111,8 @@ We didn't guess these numbers. We built a strict benchmark suite that boots our
 
 Concile actually speaks the Convex dialect. We share the same value system, the same validators, and the same shapes for queries, mutations, and actions. Your instincts will carry right over, and a simple codemod can move most of your app.
 
+Check out [Concile vs Convex](https://concile.dev/compare/convex) to see how they differ and follow the [migration guide](https://concile.dev/docs/reference/migrate-from-convex) to run the codemod.
+
 But Concile is its own distinct project with its own roadmap and its own home. We keep the door open for you, but we are building our own house.
 
 ***
diff --git a/docs/reference/migrate-from-convex.mdx b/docs/reference/migrate-from-convex.mdx
index ee78170d..f519da3a 100644
--- a/docs/reference/migrate-from-convex.mdx
+++ b/docs/reference/migrate-from-convex.mdx
@@ -654,6 +654,8 @@ are simply authoring a native concile app!
 
 ## Related
 
+- [Concile vs Convex](/compare/convex): Provides a side-by-side comparison to help you evaluate the
+  changes before migrating.
 - [What is concile?](/docs/get-started/what-is-concile): Explains why our canonical surface is
   `@concile/*` rather than `convex/*`.
 - [CLI reference](/docs/core-concepts/cli#migrate): A quick flag reference for every `concile`