diff --git a/docs/ios/open-source/linking-embrace.md b/docs/ios/open-source/linking-embrace.md
index bdf25233..b3f9cd88 100644
--- a/docs/ios/open-source/linking-embrace.md
+++ b/docs/ios/open-source/linking-embrace.md
@@ -63,3 +63,11 @@ you will need to install an additional pod:
 pod 'EmbraceCrashlyticsSupport'
 ```
 :::
+
+
+## Known Issues
+
+* We rely on [OpenTelemetry-Swift](https://github.com/open-telemetry/opentelemetry-swift/) which as of today does not
+have official CocoaPods support. We are working with the community to provide this support but in the meantime we
+work around this issue by wrapping the OpenTelemetry binary as part of our podspec. In practice this means that our SDK
+will not be compatible with other SDKs that do their own version of this work around.
\ No newline at end of file
diff --git a/docs/react-native/integration/index.md b/docs/react-native/integration/index.md
index 332dc0ec..db1bff27 100644
--- a/docs/react-native/integration/index.md
+++ b/docs/react-native/integration/index.md
@@ -26,6 +26,8 @@ This guide will walk you through integrating Embrace into your React Native appl
 
 * iOS 13.0
 * Swift 5
+* Known incompatibilities
+  * `@datadog/mobile-react-native`. More details [here](/ios/open-source/linking-embrace/#known-issues).
 
 ### Expo