diff --git a/docs/features/xml-sitemaps/api.md b/docs/features/xml-sitemaps/api.md
index e7b13d61..e9f50275 100644
--- a/docs/features/xml-sitemaps/api.md
+++ b/docs/features/xml-sitemaps/api.md
@@ -222,6 +222,8 @@ add_filter( 'wpseo_xml_sitemap_post_url', 'sitemap_post_url', 10, 2 );
 ```php
 /**
  * Alters the number of entries in each XML sitemap.
+ * 
+ * Note that the number should be either lower than 100 or a multiple of 100 to avoid problems with the sitemap pagination.
  *
  * @return integer The maximum entries per sitemap.
  */