diff --git a/README.md b/README.md
index c2d7c9f04..9690cc079 100644
--- a/README.md
+++ b/README.md
@@ -117,6 +117,9 @@ into your Xcode project.
 
 If you see, for example, a `dyld: Library not loaded: @rpath/AblyDeltaCodec.framework/AblyDeltaCodec` error, then most likely you forgot to add all the dependencies to your project. You have more detailed information [here](https://github.com/Carthage/Carthage#adding-frameworks-to-an-application).
 
+*NOTE:*
+*For **macOS** target you have to select `Do Not Embed` for `Ably.xcframework` in `General` tab for your target, and make sure the `Ably.xcframework` is on the `Link Binary With Libraries` list in `Build Phases` tab.*
+
 ### Manual installation 
 
 1. Get the code from GitHub [from the release page](https://github.com/ably/ably-cocoa/releases/tag/1.2.4), or clone it to get the latest, unstable and possibly underdocumented version: `git clone git@github.com:ably/ably-cocoa.git`