diff --git a/docs/source/documentation/2-docsearch-scraper/2-config-options.html.md.erb b/docs/source/documentation/2-docsearch-scraper/2-config-options.html.md.erb
index 966f0cf3..3bdeb022 100644
--- a/docs/source/documentation/2-docsearch-scraper/2-config-options.html.md.erb
+++ b/docs/source/documentation/2-docsearch-scraper/2-config-options.html.md.erb
@@ -383,7 +383,7 @@ Default is `0`.
 ### `custom_settings` _Optional_
 
 This object is [any custom Algolia settings](https://www.algolia.com/doc/api-client/settings/#the-scope-of-settings-and-parameters) you would like to pass to the index
-settings. You will [look under the hood of algolia](https://www.algolia.com/doc/).
+settings. Please use the python syntax. You will [look under the hood of algolia](https://www.algolia.com/doc/).
 
 ### `nb_hits_max` _Optional_
 
diff --git a/docs/source/documentation/4-docsearch-FAQ/1-customize-configuration-file.html.md.erb b/docs/source/documentation/4-docsearch-FAQ/1-customize-configuration-file.html.md.erb
index 30355613..a20f8a1b 100644
--- a/docs/source/documentation/4-docsearch-FAQ/1-customize-configuration-file.html.md.erb
+++ b/docs/source/documentation/4-docsearch-FAQ/1-customize-configuration-file.html.md.erb
@@ -76,4 +76,11 @@ You can override the way these elements are impacting the search thanks to `cust
     "desc(weight.level)"
   ]
 }
- ```
\ No newline at end of file
+ ```
+
+## Editing settings
+
+### Why the settings made from the algolia dashboard are not persistent?
+
+This situation only happens when you are running our DocSearch scraper on your own. 
+Every time you are running the crawler, every algolia settings are overridden. If you wan to use custome algolia settings, [please use `custom_settings`](https://community.algolia.com/docsearch/documentation/docsearch-scraper/config-options/#custom_settings-optional) instead.
\ No newline at end of file