diff --git a/src/fragments/lib/storage/ios/download.mdx b/src/fragments/lib/storage/ios/download.mdx
index 731275bddb0..f93f1fc99f9 100644
--- a/src/fragments/lib/storage/ios/download.mdx
+++ b/src/fragments/lib/storage/ios/download.mdx
@@ -110,6 +110,12 @@ func cancelDownload() {
You can also pause and then resume the operation.
+
+
+Note that pause internally uses the `suspend` api of `NSURLSessionTask`, which suspends the task temporarily and does not fully pause the transfer. Complete pausing of task is tracked in this Github issue - https://github.com/aws-amplify/aws-sdk-ios/issues/3668
+
+
+
```swift
storageOperation.pause()
storageOperation.resume()
diff --git a/src/fragments/lib/storage/ios/upload.mdx b/src/fragments/lib/storage/ios/upload.mdx
index 86e0fac449b..10fc8de24ba 100644
--- a/src/fragments/lib/storage/ios/upload.mdx
+++ b/src/fragments/lib/storage/ios/upload.mdx
@@ -124,6 +124,12 @@ func cancelUpload() {
You can also pause then resume the operation.
+
+
+Note that pause internally uses the `suspend` api of `NSURLSessionTask`, which suspends the task temporarily and does not fully pause the transfer. Complete pausing of task is tracked in this Github issue - https://github.com/aws-amplify/aws-sdk-ios/issues/3668
+
+
+
```swift
storageOperation.pause()
storageOperation.resume()
diff --git a/src/fragments/sdk/storage/ios/transfer-utility.mdx b/src/fragments/sdk/storage/ios/transfer-utility.mdx
index b716c4cb16a..aaaab6c6eab 100644
--- a/src/fragments/sdk/storage/ios/transfer-utility.mdx
+++ b/src/fragments/sdk/storage/ios/transfer-utility.mdx
@@ -258,6 +258,12 @@ To pause a transfer, use the `suspend` method:
refUploadTask.suspend()
```
+
+
+Note that pause internally uses the `suspend` api of `NSURLSessionTask`, which suspends the task temporarily and does not fully pause the transfer. Complete pausing of task is tracked in this Github issue - https://github.com/aws-amplify/aws-sdk-ios/issues/3668
+
+
+
## Resume a Transfer
To resume a transfer, use the `resume` method: