diff --git a/docs/build/cadence-migration-guide b/docs/build/cadence-migration-guide
new file mode 100644
index 0000000000..d47ecaa1c4
--- /dev/null
+++ b/docs/build/cadence-migration-guide
@@ -0,0 +1,15 @@
+---
+title: Cadence 1.0 Migration Guide
+sidebar_label: Cadence Migration Guide
+sidebar_position: 9
+---
+
+# Cadence 1.0 Migration Guide
+
+Coming this year, the network will be upgrading to the Cadence 1.0. This means that all applications will need to prepare and migrate their existing Cadence smart contracts, scripts, and transactions for the update. If you do not update your contracts, your applications will become non-functional after the network upgrade. The specific upgrade date will be announced later.
+
+We have created several resources to help developers update their applications. Use the following links to start upgrading your contracts and to understand how the network upgrade will affect your application:
+
+- [Understand the upgrade, the timeline, and how it affects you](https://forum.flow.com/t/cadence-1-0-upgrade-plan/5477)
+- [Learn how to update your Flow CLI to test against Cadence 1.0](https://forum.flow.com/t/update-on-cadence-1-0/5197/7)
+- [Check out the Cadence language 1.0 docs](https://cadencelang.dev/docs/1.0/)
\ No newline at end of file