diff --git a/src/corelib/platform/android/qandroidextras.cpp b/src/corelib/platform/android/qandroidextras.cpp
index 1381e8ba0f8..48868495bd9 100644
--- a/src/corelib/platform/android/qandroidextras.cpp
+++ b/src/corelib/platform/android/qandroidextras.cpp
@@ -1160,6 +1160,10 @@ requestPermissionsInternal(const QStringList &permissions)
     Requests the \a permission and returns a QFuture representing the
     result of the request.
 
+    \note QPermission is the recommended API to use for requesting permissions.
+        If QPermission doesn't cover an Android permission you want to request,
+        this preliminary API can still used instead.
+
     \since 6.2
     \sa checkPermission()
 */
@@ -1183,6 +1187,10 @@ QtAndroidPrivate::requestPermissions(const QStringList &permissions)
     Checks whether this process has the named \a permission and returns a QFuture
     representing the result of the check.
 
+    \note QPermission is the recommended API to use for requesting permissions.
+        If QPermission doesn't cover an Android permission you want to request,
+        this preliminary API can still used instead.
+
     \since 6.2
     \sa requestPermission()
 */