diff --git a/README.md b/README.md
index 4f7dee6f..a1b0b3f7 100644
--- a/README.md
+++ b/README.md
@@ -60,13 +60,14 @@ const searchClient = instantMeiliSearch(
);
```
-- `paginationTotalHits` (`200` by default): The total (and finite) number of hits you can browse during pagination.
-It means, by default, you can browse `paginationTotalHits / hitsPerPage = 200 / 20 = 10` pages during pagination.
-By default, `hitsPerPage` is set to `20` but it can be changed with [`InsantSearch.configure`](https://www.algolia.com/doc/api-reference/widgets/configure/js/#examples)
-If the pagination widget is not set, this parameter is ignored.
-
- `placeholderSearch` (`true` by default). Displays documents even when the query is empty.
+- `paginationTotalHits` (`200` by default): The total (and finite) number of hits you can browse during pagination when using the [pagination widget](https://www.algolia.com/doc/api-reference/widgets/pagination/js/). If the pagination widget is not used, `paginationTotalHits` is ignored.
+Which means that, with a `paginationTotalHits` default value of 200, and `hitsPerPage` default value of 20, you can browse `paginationTotalHits / hitsPerPage` => `200 / 20 = 10` pages during pagination. Each of the 10 pages containing 20 results.
+The default value of `hitsPerPage` is set to `20` but it can be changed with [`InsantSearch.configure`](https://www.algolia.com/doc/api-reference/widgets/configure/js/#examples).
+⚠️ MeiliSearch is not designed for pagination and this can lead to performances issues, so the usage of the pagination widget is not encouraged. However, the `paginationTotalHits` parameter lets you implement this pagination with less performance issue as possible: depending on your dataset (the size of each document and the number of documents) you might decrease the value of `paginationTotalHits`.
+More information about MeiliSearch and the pagination [here](https://github.com/meilisearch/documentation/issues/561).
+
## Example with InstantSearch
The open-source [InstantSearch](https://www.algolia.com/doc/api-reference/widgets/js/) library powered by Algolia provides all the front-end tools you need to highly customize your search bar environment.