diff --git a/docs/configuration.md b/docs/configuration.md
index 7a5daa53..1796b7df 100644
--- a/docs/configuration.md
+++ b/docs/configuration.md
@@ -128,6 +128,14 @@ then `HISTORY_SAVE_CHANGED_FIELDS`, `HISTORY_SAVE_CHANGED_DATA` and `HISTORY_SAV
 * `ERROR_PAGE_SHOW_HELP`: Set this 0, to disable the solution hints shown on an error page. These hints should not
   contain sensitive information, but could confuse end-users.
 
+### EDA related settings
+
+* `EDA_KICAD_CATEGORY_DEPTH`: A number, which determines how many levels of Part-DB categories should be shown inside KiCad.
+   All parts in the selected category and all subcategories are shown in KiCad.
+   For performance reason this value should not be too high. The default is 0, which means that only the top level categories are shown in KiCad.
+   All parts in the selected category and all subcategories are shown in KiCad. Set this to a higher value, if you want to show more categories in KiCad.
+   When you set this value to -1, all parts are shown inside a single category in KiCad.
+
 ### SAML SSO settings
 
 The following settings can be used to enable and configure Single-Sign on via SAML. This allows users to log in to
diff --git a/docs/usage/eda_integration.md b/docs/usage/eda_integration.md
index 55d0a770..11c4b231 100644
--- a/docs/usage/eda_integration.md
+++ b/docs/usage/eda_integration.md
@@ -55,4 +55,15 @@ You can define this on a per-part basis using the KiCad symbol and KiCad footpri
 
 For example to configure the values for an BC547 transistor you would put `Transistor_BJT:BC547` on the parts Kicad symbol to give it the right schematic symbol in EEschema and `Package_TO_SOT_THT:TO-92` to give it the right footprint in PcbNew.
 
-If you type in a character, you will get an autocomplete list of all symbols and footprints available in the kicad standard library. You can also input your own value.
\ No newline at end of file
+If you type in a character, you will get an autocomplete list of all symbols and footprints available in the kicad standard library. You can also input your own value.
+
+### Category depth in KiCad
+
+For performance reasons, only the most top level categories of Part-DB are shown as categories in KiCad. All parts in the subcategories are shown in the top level category.
+
+You can configure the depth of the categories shown in KiCad, via the `EDA_KICAD_CATEGORY_DEPTH` env option. The default value is 0, which meabs only the top level categories are shown.
+To show more levels of categories, you can set this value to a higher number.
+
+If you set this value to -1, all parts are shown inside a single category in KiCad, without any subcategories.
+
+You can view the "real" category path of a part in the part details dialog in KiCad.
\ No newline at end of file