coder · aslilac · Oct 12, 2023 · Oct 11, 2023 · Oct 11, 2023 · Oct 12, 2023
diff --git a/docs/images/icons-gallery.png b/docs/images/icons-gallery.png
diff --git a/docs/manifest.json b/docs/manifest.json
@@ -207,6 +207,11 @@
           "description": "Audit commands in workspaces with exectrace",
           "path": "./templates/process-logging.md",
           "state": "enterprise"
+        },
+        {
+          "title": "Icons",
+          "description": "Coder includes icons for popular cloud providers and programming languages for you to use",
+          "path": "./templates/icons.md"
         }
       ]
     },

diff --git a/docs/templates/icons.md b/docs/templates/icons.md
@@ -0,0 +1,20 @@
+# Icons
+
+---
+
+Coder uses icons in several places, including ones that can be configured
+throughout the app, or specified in your Terraform. They're specified by a URL,
+which can be to an image hosted on a CDN of your own, or one of the icons that
+come included with your Coder deployment.
+
+## Included icons
+
+Coder includes icons for popular cloud providers and programming languages. You
+can see all of the icons (or suggest new ones) in our repository on
+[GitHub](https://github.com/coder/coder/tree/main/site/static/icon).
+
+You can also view the entire list, with search, by navigating to /icons on your
+Coder deployment. E.g. [https://coder.example.com/icons](#). This can be
+particularly useful in airgapped deployments.
+
+![The icon gallery](../images/icons-gallery.png)