diff --git a/admin_manual/configuration_server/theming.rst b/admin_manual/configuration_server/theming.rst
index ecfc07476bb..1b1a98956d0 100644
--- a/admin_manual/configuration_server/theming.rst
+++ b/admin_manual/configuration_server/theming.rst
@@ -18,3 +18,15 @@ In the administrative settings you can modify the appearance of Nextcloud:
 Log in page   
 
 .. figure:: ../configuration_server/images/theming-log-in-page.png
+
+Theming of icons
+================
+
+Nextcloud will automatically generate favicons and home screen icons
+depending on the current app and theming color. 
+
+This requires the following additional dependencies:
+
+ - PHP module imagick
+ - SVG support for imagick (e.g. `libmagickcore5-extra`)
+
diff --git a/admin_manual/operations/theming.rst b/admin_manual/operations/theming.rst
index 4ea74638d27..86945113bb9 100644
--- a/admin_manual/operations/theming.rst
+++ b/admin_manual/operations/theming.rst
@@ -6,4 +6,7 @@ Theming Nextcloud
     :maxdepth: 2
     :hidden:
 
-The theming is documented in the `developers documentation <../../developer_manual/core/theming.html>`_.
+
+Theming can be done very easily using the shipped `theming app <../configuration_server/theming.html>`_, which is enabled by default.
+
+For more individual theming options please head over to the `developers documentation <../../developer_manual/core/theming.html>`_.
diff --git a/developer_manual/app/theming.rst b/developer_manual/app/theming.rst
index e382b57cbfd..35314413413 100644
--- a/developer_manual/app/theming.rst
+++ b/developer_manual/app/theming.rst
@@ -34,3 +34,9 @@ The following information is available:
 * **OCA.Theming.slogan** Instance slogan
 * **OCA.Theming.url**  Instance web address
 
+Icons
+=====
+
+The theming app will automatically generate favicons and home screen icons for
+each app by using the icon `img/app.svg` inside of the app folder. Any custom
+favicon set by an app will only be visible when the theming app is disabled.