diff --git a/docs/api-reference/user-interface/grid.md b/docs/api-reference/user-interface/grid.md
index 0e209b0c0da..10d8cb79d23 100644
--- a/docs/api-reference/user-interface/grid.md
+++ b/docs/api-reference/user-interface/grid.md
@@ -251,6 +251,10 @@ export default function Command() {
 
 {% endtabs %}
 
+{% hint style="warning" %}
+Pagination might not work properly if all grid items are rendered and visible at once, as `onLoadMore` won't be triggered. This typically happens when an API returns 10 results by default, all fitting within the Raycast window. To fix this, try displaying more items, like 20.
+{% endhint %}
+
 ## Examples
 
 {% tabs %}
diff --git a/docs/api-reference/user-interface/list.md b/docs/api-reference/user-interface/list.md
index aa261d9049c..eae51a46ac8 100644
--- a/docs/api-reference/user-interface/list.md
+++ b/docs/api-reference/user-interface/list.md
@@ -251,6 +251,10 @@ export default function Command() {
 {% endtab %}
 {% endtabs %}
 
+{% hint style="warning" %}
+Pagination might not work properly if all list items are rendered and visible at once, as `onLoadMore` won't be triggered. This typically happens when an API returns 10 results by default, all fitting within the Raycast window. To fix this, try displaying more items, like 20.
+{% endhint %}
+
 ## Examples
 
 {% tabs %}