diff --git a/packages/amplify_core/lib/src/types/api/graphql/graphql_response.dart b/packages/amplify_core/lib/src/types/api/graphql/graphql_response.dart
index 5e7ae3a04e5..0398e2b383b 100644
--- a/packages/amplify_core/lib/src/types/api/graphql/graphql_response.dart
+++ b/packages/amplify_core/lib/src/types/api/graphql/graphql_response.dart
@@ -16,7 +16,9 @@ class GraphQLResponse<T> {
 
   /// Response data matching the type of the request.
   ///
-  /// This will be `null` if there are any GraphQL errors during execution.
+  /// Per GraphQL, [data] and [errors] are separate response fields: [data] may
+  /// be non-null when [errors] is non-empty (partial success). Check [hasErrors]
+  /// before treating the response as fully successful.
   final T? data;
 
   /// A list of errors from execution. If no errors, it will be an empty list.