aws-amplify · tylerjroach · Aug 1, 2025 · Aug 1, 2025
diff --git a/src/fragments/lib-v1/android-sdk.mdx b/src/fragments/lib-v1/android-sdk.mdx
@@ -15,9 +15,3 @@ While Amplify aims to build in best practices with sensible defaults, there are
 We use the term “library” to refer to programming interfaces that have been hand authored for these category based use cases, and use “SDK” to refer to lower-level programming interfaces which have largely been auto-generated from underlying backend service interfaces and are implementation specific. The existing AWS Mobile SDK contains helper classes, utilities, and a set of code-generated, implementation specific APIs defined by AWS service interfaces. You can use it in your app via an escape hatch if you need lower level control.
 
 This guide shows how to build an app using the AWS Mobile SDK for Android and the Amplify CLI toolchain. To use our new developer experience refer to the [Amplify Libraries for Android guide](/gen1/[platform]/tools/libraries/).
-
-### Should I use the Amplify libraries or AWS Mobile SDK?
-
-Amplify libraries should be used for all new applications. 
-
-For existing applications, we recommend you evaluate migration to the Amplify libraries. The AWS Mobile SDK will continue be maintained with bug fixes and security updates.
diff --git a/src/fragments/lib-v1/ios-sdk.mdx b/src/fragments/lib-v1/ios-sdk.mdx
@@ -1,4 +1,4 @@
-The AWS Mobile SDK for iOS enables you to build mobile apps by providing simplified APIs for AWS services such as Amazon Cognito, Amazon S3, AWS AppSync and more.
+The AWS Mobile SDK for iOS enables you to build mobile apps by providing simplified APIs for AWS services such as Amazon Cognito, Amazon S3, AWS AppSync and more. You can view the Mobile SDK API reference [here](https://aws-amplify.github.io/aws-sdk-ios/docs/reference).
 
 import all0 from "/src/fragments/sdk/library-callout.mdx";
 
@@ -15,9 +15,3 @@ While Amplify aims to build in best practices with sensible defaults, there are
 We use the term “library” to refer to programming interfaces that have been hand authored for these category based use cases, and use “SDK” to refer to lower-level programming interfaces which have largely been auto-generated from underlying backend service interfaces and are implementation specific. The existing AWS Mobile SDK contains helper classes, utilities, and a set of code-generated, implementation specific APIs defined by AWS service interfaces. You can use it in your app via an escape hatch if you need lower level control.
 
 This guide shows how to build an app using the AWS Mobile SDK for iOS and the Amplify CLI toolchain. To use our new developer experience refer to the [Amplify Libraries for iOS guide](/gen1/[platform]/tools/libraries/).
-
-### Should I use the Amplify libraries or AWS Mobile SDK?
-
-Amplify libraries should be used for all new applications. 
-
-For existing applications, we recommend you evaluate migration to the Amplify libraries. The AWS Mobile SDK will continue be maintained with bug fixes and security updates.
diff --git a/src/fragments/lib/android-sdk.mdx b/src/fragments/lib/android-sdk.mdx
@@ -15,9 +15,3 @@ While Amplify aims to build in best practices with sensible defaults, there are
 We use the term “library” to refer to programming interfaces that have been hand authored for these category based use cases, and use “SDK” to refer to lower-level programming interfaces which have largely been auto-generated from underlying backend service interfaces and are implementation specific. The existing AWS Mobile SDK contains helper classes, utilities, and a set of code-generated, implementation specific APIs defined by AWS service interfaces. You can use it in your app via an escape hatch if you need lower level control.
 
 This guide shows how to build an app using the AWS Mobile SDK for Android and the Amplify CLI toolchain. To use our new developer experience refer to the [Amplify Libraries for Android guide](/gen1/[platform]/tools/libraries/).
-
-### Should I use the Amplify libraries or AWS Mobile SDK?
-
-Amplify libraries should be used for all new applications. 
-
-For existing applications, we recommend you evaluate migration to the Amplify libraries. The AWS Mobile SDK will continue be maintained with bug fixes and security updates.
diff --git a/src/fragments/lib/ios-sdk.mdx b/src/fragments/lib/ios-sdk.mdx
@@ -1,4 +1,4 @@
-The AWS Mobile SDK for iOS enables you to build mobile apps by providing simplified APIs for AWS services such as Amazon Cognito, Amazon S3, AWS AppSync and more.
+The AWS Mobile SDK for iOS enables you to build mobile apps by providing simplified APIs for AWS services such as Amazon Cognito, Amazon S3, AWS AppSync and more. You can view the Mobile SDK API reference [here](https://aws-amplify.github.io/aws-sdk-ios/docs/reference).
 
 import all0 from "/src/fragments/sdk/library-callout.mdx";
 
@@ -15,9 +15,3 @@ While Amplify aims to build in best practices with sensible defaults, there are
 We use the term “library” to refer to programming interfaces that have been hand authored for these category based use cases, and use “SDK” to refer to lower-level programming interfaces which have largely been auto-generated from underlying backend service interfaces and are implementation specific. The existing AWS Mobile SDK contains helper classes, utilities, and a set of code-generated, implementation specific APIs defined by AWS service interfaces. You can use it in your app via an escape hatch if you need lower level control.
 
 This guide shows how to build an app using the AWS Mobile SDK for iOS and the Amplify CLI toolchain. To use our new developer experience refer to the [Amplify Libraries for iOS guide](/gen1/[platform]/tools/libraries/).
-
-### Should I use the Amplify libraries or AWS Mobile SDK?
-
-Amplify libraries should be used for all new applications. 
-
-For existing applications, we recommend you evaluate migration to the Amplify libraries. The AWS Mobile SDK will continue be maintained with bug fixes and security updates.
diff --git a/src/fragments/sdk/library-callout.mdx b/src/fragments/sdk/library-callout.mdx
@@ -1,9 +1,35 @@
 <Callout warning>
 
-You are currently viewing the AWS SDK for Mobile documentation which is a collection of low-level libraries. Use the Amplify libraries for all new app development. [Learn more](/gen1/[platform]/tools/libraries/)
+<InlineFilter filters={['android']}>
 
-import ios0 from '/src/fragments/sdk/sdk-api-ref/ios.mdx';
+The AWS SDK for Android entered Maintenance Phase as of August 1, 2025.
 
-<Fragments fragments={{ swift: ios0 }} />
+During this maintenance period:
+
+* Critical bug fixes and security patches will continue to be provided
+* No new features or enhancements will be added
+* Existing functionality will remain supported
+
+We recommend that you start using [AWS Amplify for Android](/[platform]), our modern feature-rich library designed specifically for building cloud-connected apps powered by AWS. You can refer to the [AWS SDK for Android migration guide](https://github.com/aws-amplify/amplify-android/blob/main/documents/MobileSDK_To_AmplifyAndroid.md) to help you transition to AWS Amplify for Android.
+
+This version is scheduled to reach End of Support on August 1, 2026. After this date, no further updates of any kind will be provided. See [maintenance policy](/reference/maintenance-policy) for more information about the Amplify Client Library lifecycle.
+
+</InlineFilter>
+
+<InlineFilter filters={['swift']}>
+
+The AWS SDK for iOS entered Maintenance Phase as of August 1, 2025.
+
+During this maintenance period:
+
+* Critical bug fixes and security patches will continue to be provided
+* No new features or enhancements will be added
+* Existing functionality will remain supported
+
+We recommend that you start using [AWS Amplify for iOS](/[platform]), our modern feature-rich library designed specifically for building cloud-connected apps powered by AWS. You can refer to the [AWS SDK for iOS migration guide](https://github.com/aws-amplify/amplify-swift/blob/main/MobileSDK_To_AmplifySwift_Guidance.md) to help you transition to AWS Amplify for Swift.
+
+This version is scheduled to reach End of Support on August 1, 2026. After this date, no further updates of any kind will be provided. See [maintenance policy](https://docs.amplify.aws/reference/maintenance-policy) for more information about the Amplify Client Library lifecycle.
+
+</InlineFilter>
 
 </Callout>
diff --git a/src/fragments/sdk/sdk-api-ref/ios.mdx b/src/fragments/sdk/sdk-api-ref/ios.mdx