diff --git a/docs/usage/reading/pagination.md b/docs/usage/reading/pagination.md
index ea4e30e62..e53ae1c3a 100644
--- a/docs/usage/reading/pagination.md
+++ b/docs/usage/reading/pagination.md
@@ -18,6 +18,10 @@ and on included resources, for example:
 GET /api/blogs/1/articles?include=revisions&page[size]=10,revisions:5&page[number]=2,revisions:3 HTTP/1.1
 ```
 
+> [!NOTE]
+> For optimal performance, pagination links and total meta are not returned for *included* to-many relationships.
+> See [here](https://github.com/json-api-dotnet/JsonApiDotNetCore/issues/1738) for details.
+
 ## Configuring Default Behavior
 
 You can configure the global default behavior as described [here](~/usage/options.md#pagination).