diff --git a/docs/usage/eda_integration.md b/docs/usage/eda_integration.md
index 11c4b231..3bbee4da 100644
--- a/docs/usage/eda_integration.md
+++ b/docs/usage/eda_integration.md
@@ -25,7 +25,8 @@ You require a user account in Part-DB, which has the permission to access Part-D
 To connect KiCad with Part-DB do following steps:
 
 1. Create an API token on the user settings page for the KiCAD application and copy/save it, when it is shown. Currently KiCAD can only read Part-DB database, so a token with read only scope is enough.
-2. Create a file `partd.kicad_httplib` (or similar, only the extension is important) with the following content:
+2. Add some EDA metadata to parts, categories or footprints. Only parts with useable info will show up in KiCad. See below for more info.
+3. Create a file `partd.kicad_httplib` (or similar, only the extension is important) with the following content:
 ```
 {
     "meta": {
@@ -41,11 +42,11 @@ To connect KiCad with Part-DB do following steps:
     }
 }    
 ```
-3. Replace the `root_url` with the URL of your Part-DB instance plus `/en/kicad-api/`. You can find the right value for this in the Part-DB user settings page under "API endpoints" in the "API tokens" panel.
-4. Replace the `token` field value with the token you have generated in step 1.
-5. Open KiCad and add this created file as library in the KiCad symbol table under (Preferences --> Manage Symbol Libraries)
+4. Replace the `root_url` with the URL of your Part-DB instance plus `/en/kicad-api/`. You can find the right value for this in the Part-DB user settings page under "API endpoints" in the "API tokens" panel.
+5. Replace the `token` field value with the token you have generated in step 1.
+6. Open KiCad and add this created file as library in the KiCad symbol table under (Preferences --> Manage Symbol Libraries)
 
-If you then place a new part, the library dialog opens and you should be able to see the categories and parts from Part-DB.
+If you then place a new part, the library dialog opens, and you should be able to see the categories and parts from Part-DB.
 
 ### How to associate footprints and symbols with parts
 
@@ -57,6 +58,15 @@ For example to configure the values for an BC547 transistor you would put `Trans
 
 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.
 
+### Parts and category visibility
+
+Only parts and their categories, on which there is any kind of EDA metadata are defined show up in KiCad. So if you want to see parts in KiCad,
+you need to define at least a symbol, footprint, reference prefix or value on a part, category or footprint.
+
+You can use the "Force visibility" checkbox on a part or category to override this behavior and force parts to be visible or hidden in KiCad.
+
+*Please note that KiCad caches the library categories. So if you change something, which would change the visibile categories in KiCad, you have to reload EEschema to see the changes.*
+
 ### 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.