diff --git a/CHANGELOG.md b/CHANGELOG.md
index 25f17fa8a..360d9a2b3 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -7,7 +7,8 @@ This contains only the most important and/or user-facing changes; for a full cha
 The 2.0.0 release introduces a number of new features and QoL improvements, including a new way to remove bloat and reduce the bundle size of your ably-js client, first-class support for Promises, a more idiomatic approach to using ably-js' React Hooks, enhancements to TypeScript typings, and more.
 
 Below is an overview of the major changes in this release.
-Please refer to the [ably-js v2 migration guide](link TBD) for the full details, including a list of all breaking changes and instructions on how to address them.
+
+Please refer to the ably-js v2 [lib migration guide](./docs/migration-guides/v2/lib.md) and [React Hooks migration guide](./docs/migration-guides/v2/react-hooks.md) for the full details, including a list of all breaking changes and instructions on how to address them.
 
 ### Bundle Size Reduction