docs: add workspace_apps documentation

blink-so[bot] · blink-so[bot] · commit 743975ee7fcf · 2025-07-19T19:46:58.000Z
Add comprehensive documentation for the new workspace_apps feature:
- Explain how to configure which apps appear in workspace table
- Provide example with both built-in and custom apps
- Document valid app identifiers
- Clarify default behavior when workspace_apps is not specified
diff --git a/docs/admin/templates/extending-templates/index.md b/docs/admin/templates/extending-templates/index.md
@@ -87,6 +87,42 @@ and can be hidden directly in the
 resource. You can arrange the display orientation of Coder apps in your template
 using [resource ordering](./resource-ordering.md).
 
+#### Configuring workspace table apps
+
+By default, all available apps (both built-in `display_apps` and custom `coder_app` resources) are shown as action buttons in the workspace table. You can customize which apps appear in the workspace table by using the `workspace_apps` attribute in the `coder_agent` resource:
+
+```tf
+resource "coder_agent" "dev" {
+  os   = "linux"
+  arch = "amd64"
+  dir  = "/workspace"
+  
+  # Only show VS Code and a custom app in the workspace table
+  workspace_apps = ["vscode", "my-custom-app"]
+  
+  display_apps {
+    vscode = true
+    web_terminal = true
+  }
+}
+
+resource "coder_app" "my-custom-app" {
+  agent_id     = coder_agent.dev.id
+  slug         = "my-custom-app"
+  display_name = "My Custom App"
+  url          = "http://localhost:8080"
+  icon         = "/icon/custom.svg"
+}
+```
+
+In this example, even though both VS Code and Web Terminal are enabled in `display_apps`, only VS Code and the custom app will appear as action buttons in the workspace table. All apps remain accessible from the workspace detail page.
+
+The `workspace_apps` list can contain:
+- Built-in app identifiers: `"vscode"`, `"vscode_insiders"`, `"web_terminal"`, `"ssh_helper"`, `"port_forwarding_helper"`
+- Custom app slugs from `coder_app` resources
+
+If `workspace_apps` is not specified, all available apps are shown in the workspace table (default behavior).
+
 ### Coder app examples
 
 <div class="tabs">
