diff --git a/commands-yml/commands/device/clipboard/get-clipboard.yml b/commands-yml/commands/device/clipboard/get-clipboard.yml
index 5e13128ae..d8ba34da2 100644
--- a/commands-yml/commands/device/clipboard/get-clipboard.yml
+++ b/commands-yml/commands/device/clipboard/get-clipboard.yml
@@ -5,6 +5,10 @@ description:
   >
     Get the content of the system clipboard
 
+
+    (For iOS real devices)
+    Apple security preferences require the WebDriverAgentRunner application to be in [foreground](https://github.com/appium/WebDriverAgent/issues/330) in order to be able to receive the system clipboard content. Otherwise an empty string is always returned. Consider using [Activate App](/docs/en/commands/device/app/activate-app.md) and [Background App](/docs/en/commands/device/app/background-app.md) to change the foreground application.
+
 example_usage:
   java:
     |
diff --git a/docs/en/writing-running-appium/ios/ios-xctest-pasteboard.md b/docs/en/writing-running-appium/ios/ios-xctest-pasteboard.md
index 4f947adeb..4984f4be9 100644
--- a/docs/en/writing-running-appium/ios/ios-xctest-pasteboard.md
+++ b/docs/en/writing-running-appium/ios/ios-xctest-pasteboard.md
@@ -3,8 +3,7 @@
 There is a possibility in Appium to set the content of the iOS Simulator pasteboard
 and read the content from there if needed. Each Simulator maintains its own pasteboard.
 This feature is only available since Xcode SDK 8.1.
-
-It might work when WebDriverAgentRunner is in [foreground on real devices](https://github.com/appium/WebDriverAgent/issues/330).
+On real devices this functionaliry is available with several security limitations. Please check [Get Clipboard](/docs/en/commands/device/clipboard/get-clipboard.md)/[Set Clipboard](/docs/en/commands/device/clipboard/set-clipboard.md) for more details.
 
 ### mobile: setPasteboard