coder · nickvigilante · Aug 11, 2026 · Aug 11, 2026
diff --git a/docs/README.md b/docs/README.md
@@ -1,4 +1,6 @@
-# About
+---
+title: About
+---
 
 <!-- Warning for docs contributors: The first route in manifest.json must be titled "About" for the static landing page to work correctly. -->
 

diff --git a/docs/about/contributing/AI_CONTRIBUTING.md b/docs/about/contributing/AI_CONTRIBUTING.md
@@ -1,4 +1,6 @@
-# AI Contribution Guidelines
+---
+title: AI Contribution Guidelines
+---
 
 This document defines rules for contributions where an AI system is the primary author of the code (i.e., most of the pull request was generated by AI).
 It applies to all Coder repositories and is a supplement to the [existing contributing guidelines](./CONTRIBUTING.md), not a replacement.

diff --git a/docs/about/contributing/CONTRIBUTING.md b/docs/about/contributing/CONTRIBUTING.md
@@ -1,4 +1,6 @@
-# Contributing
+---
+title: Contributing
+---
 
 ## Requirements
 
@@ -91,7 +93,7 @@
 `pre-push` is skipped entirely. Changes to Go, TypeScript, SQL, proto, or
 the Makefile trigger the full targets as before.

 ### Running Coder on development mode

 1. Run the development script to spin up the local environment:

@@ -129,7 +131,7 @@
   ./scripts/coder-dev.sh create my-workspace -t docker
   ```

 ### Deploying a PR

 You need to be a member or collaborator of the [coder](https://github.com/coder) GitHub organization to be able to deploy a PR.

@@ -258,7 +260,7 @@
 The workflow validates that commits are on the expected branch for each release
 type.

 ### Retrying a failed release

 If the
 [`release.yaml`](https://github.com/coder/coder/actions/workflows/release.yaml)
@@ -300,7 +302,7 @@
 formatted title. Take care when merging single-commit PRs as GitHub may prefer
 to use the original commit title instead of the PR title.

 ### Backporting fixes to release branches

 When a merged PR on `main` should also ship in older releases, add the
 `backport` label to the PR. The

diff --git a/docs/about/contributing/backend.md b/docs/about/contributing/backend.md
@@ -1,4 +1,6 @@
-# Backend
+---
+title: Backend
+---
 
 This guide is designed to support both Coder engineers and community contributors in understanding our backend systems and getting started with development.
 
@@ -86,7 +88,7 @@
 * [tailnet](../../../tailnet): core logic of Tailnet controller to maintain DERP maps, coordinate connections with agents and peers
 * [vpn](../../../vpn): Coder Desktop (VPN) and tunneling components

 ## Testing

 The Coder backend includes a rich suite of unit and end-to-end tests. A variety of helper utilities are used throughout the codebase to make testing easier, more consistent, and closer to real behavior.

@@ -142,7 +144,7 @@

 ## Recipes

 ### Adding database migrations and fixtures

 #### Database migrations


diff --git a/docs/about/contributing/documentation.md b/docs/about/contributing/documentation.md
@@ -1,4 +1,6 @@
-# Documentation
+---
+title: Documentation
+---
 
 This style guide is primarily for use with authoring documentation.
 

diff --git a/docs/about/contributing/frontend.md b/docs/about/contributing/frontend.md
@@ -1,4 +1,6 @@
-# Frontend
+---
+title: Frontend
+---
 
 Welcome to the guide for contributing to the Coder frontend. Whether you’re part
 of the community or a Coder team member, this documentation will help you get
@@ -8,7 +10,7 @@
 [Discord server](https://discord.com/invite/coder), and we’ll be happy to assist
 you.

 ## Running the UI

 You can run the UI and access the Coder dashboard in two ways:

@@ -88,7 +90,7 @@
 If code within a page becomes reusable across other parts of the app,
 consider moving it to `src/utils`, `hooks`, `components`, or `modules`.

 ### Handling States

 A page typically has three states: **loading**, **ready**/**success**, and
 **error**. Ensure you manage these states when developing pages. Use visual
@@ -253,7 +255,7 @@
 We use [Formik](https://formik.org/docs) for forms along with
 [Yup](https://github.com/jquense/yup) for schema definition and validation.

 ## Testing

 We use three types of testing in our app: **End-to-end (E2E)**, **Integration/Unit**
 and **Visual Testing**.
@@ -311,7 +313,7 @@
 time-consuming. Sometimes it is because the test itself is complex and sometimes
 it is because of how the test is querying elements.

 #### Using `ByRole` queries

 One thing we figured out that was slowing down our tests was the use of `ByRole`
 queries because of how it calculates the role attribute for every element on the

diff --git a/docs/about/screenshots.md b/docs/about/screenshots.md
@@ -1,4 +1,6 @@
-# Screenshots
+---
+title: Screenshots
+---
 
 ## Log in
 

diff --git a/docs/admin/external-auth/index.md b/docs/admin/external-auth/index.md
@@ -1,4 +1,6 @@
-# External Authentication
+---
+title: External Authentication
+---
 
 Coder supports external authentication via OAuth2.0. This allows enabling any OAuth provider as well as integrations with Git providers,
 such as GitHub, GitLab, and Bitbucket.

diff --git a/docs/admin/index.md b/docs/admin/index.md
@@ -1,4 +1,6 @@
-# Administration
+---
+title: Administration
+---
 
 ![Admin settings general page](../images/admin/admin-settings-general.png)
 

diff --git a/docs/admin/infrastructure/architecture.md b/docs/admin/infrastructure/architecture.md
@@ -1,4 +1,6 @@
-# Architecture
+---
+title: Architecture
+---
 
 The Coder deployment model is flexible and offers various components that
 platform administrators can deploy and scale depending on their use case. This

diff --git a/docs/admin/infrastructure/index.md b/docs/admin/infrastructure/index.md
@@ -1,4 +1,6 @@
-# Infrastructure
+---
+title: Infrastructure
+---
 
 Learn how to spin up & manage Coder infrastructure.
 

diff --git a/docs/admin/infrastructure/scale-testing.md b/docs/admin/infrastructure/scale-testing.md
@@ -1,4 +1,6 @@
-# Scale Testing
+---
+title: Scale Testing
+---
 
 Scaling Coder involves planning and testing to ensure it can handle more load
 without compromising service. This process encompasses infrastructure setup,

diff --git a/docs/admin/integrations/devcontainers/envbuilder/add-envbuilder.md b/docs/admin/integrations/devcontainers/envbuilder/add-envbuilder.md
@@ -1,4 +1,6 @@
-# Add an Envbuilder template
+---
+title: Add an Envbuilder template
+---
 
 A Coder administrator adds an Envbuilder-compatible template to Coder. This
 allows the template to prompt the developer for their dev container repository's

diff --git a/docs/admin/integrations/devcontainers/envbuilder/index.md b/docs/admin/integrations/devcontainers/envbuilder/index.md
@@ -1,4 +1,6 @@
-# Envbuilder
+---
+title: Envbuilder
+---
 
 Envbuilder is an open-source tool that builds development environments from
 [dev container](https://containers.dev/implementors/spec/) configuration files.

diff --git a/docs/admin/integrations/devcontainers/index.md b/docs/admin/integrations/devcontainers/index.md
@@ -1,4 +1,6 @@
-# Dev Containers
+---
+title: Dev Containers
+---
 
 Dev containers allow developers to define their development environment
 as code using the [Dev Container specification](https://containers.dev/).

diff --git a/docs/admin/integrations/index.md b/docs/admin/integrations/index.md
@@ -1,4 +1,6 @@
-# Integrations
+---
+title: Integrations
+---
 
 Coder is highly extensible and is not limited to the platforms outlined in these
 docs. The control plane can be provisioned on any VM or container compute, and

diff --git a/docs/admin/integrations/platformx.md b/docs/admin/integrations/platformx.md
@@ -1,4 +1,6 @@
-# DX PlatformX
+---
+title: DX PlatformX
+---
 
 [DX](https://getdx.com) is a developer intelligence platform used by engineering
 leaders and platform engineers. Coder notifications can be transformed to

diff --git a/docs/admin/licensing/index.md b/docs/admin/licensing/index.md
@@ -1,4 +1,6 @@
-# Licensing
+---
+title: Licensing
+---
 
 Some features are only accessible with a Premium license, including
 [AI Governance](../../ai-coder/ai-governance.md). See our

diff --git a/docs/admin/monitoring/logs.md b/docs/admin/monitoring/logs.md
@@ -1,4 +1,6 @@
-# Logs
+---
+title: Logs
+---
 
 All Coder services log to standard output, which can be critical for identifying
 errors and monitoring Coder's deployment health. Like any service, logs can be

diff --git a/docs/admin/monitoring/notifications/index.md b/docs/admin/monitoring/notifications/index.md
@@ -1,4 +1,6 @@
-# Notifications
+---
+title: Notifications
+---
 
 Notifications are sent by Coder in response to specific internal events, such as
 a workspace being deleted or a user being created.

diff --git a/docs/admin/monitoring/notifications/slack.md b/docs/admin/monitoring/notifications/slack.md
@@ -1,4 +1,6 @@
-# Slack Notifications
+---
+title: Slack Notifications
+---
 
 [Slack](https://slack.com/) is a popular messaging platform designed for teams
 and businesses, enabling real-time collaboration through channels, direct

diff --git a/docs/admin/monitoring/notifications/teams.md b/docs/admin/monitoring/notifications/teams.md
@@ -1,4 +1,6 @@
-# Microsoft Teams Notifications
+---
+title: Microsoft Teams Notifications
+---
 
 [Microsoft Teams](https://www.microsoft.com/en-us/microsoft-teams) is a widely
 used collaboration platform, and with Coder's integration, you can enable

diff --git a/docs/admin/networking/high-availability.md b/docs/admin/networking/high-availability.md
@@ -1,4 +1,6 @@
-# High Availability
+---
+title: High Availability
+---
 
 High Availability (HA) mode solves for horizontal scalability and automatic
 failover within a single region. When in HA mode, Coder continues using a single

diff --git a/docs/admin/networking/index.md b/docs/admin/networking/index.md
@@ -1,4 +1,6 @@
-# Networking
+---
+title: Networking
+---
 
 Coder's network topology has three types of nodes: workspaces, coder servers,
 and users.

diff --git a/docs/admin/networking/port-forwarding.md b/docs/admin/networking/port-forwarding.md
@@ -1,4 +1,6 @@
-# Port Forwarding
+---
+title: Port Forwarding
+---
 
 Port forwarding lets developers securely access processes on their Coder
 workspace from a local machine. A common use case is testing web applications in

diff --git a/docs/admin/networking/stun.md b/docs/admin/networking/stun.md
@@ -1,4 +1,6 @@
-# STUN and NAT
+---
+title: STUN and NAT
+---
 
 [Session Traversal Utilities for NAT (STUN)](https://www.rfc-editor.org/rfc/rfc8489.html)
 is a protocol used to assist applications in establishing peer-to-peer

diff --git a/docs/admin/networking/troubleshooting.md b/docs/admin/networking/troubleshooting.md
@@ -1,4 +1,6 @@
-# Troubleshooting
+---
+title: Troubleshooting
+---
 
 `coder ping <workspace>` will ping the workspace agent and print diagnostics on
 the state of the connection. These diagnostics are created by inspecting both

diff --git a/docs/admin/security/database-encryption.md b/docs/admin/security/database-encryption.md
@@ -1,4 +1,6 @@
-# Database Encryption
+---
+title: Database Encryption
+---
 
 By default, Coder stores external user tokens and other sensitive values in
 plaintext in the database. Database Encryption allows Coder administrators to

diff --git a/docs/admin/security/index.md b/docs/admin/security/index.md
@@ -1,4 +1,6 @@
-# Security
+---
+title: Security
+---
 
 <children></children>
 

diff --git a/docs/admin/security/secrets.md b/docs/admin/security/secrets.md
@@ -1,4 +1,6 @@
-# Secrets
+---
+title: Secrets
+---
 
 Coder is open-minded about how you get your secrets into your workspaces. For
 more information about how to use secrets and other security tips, visit our

diff --git a/docs/admin/setup/data-retention.md b/docs/admin/setup/data-retention.md
@@ -1,4 +1,6 @@
-# Data Retention
+---
+title: Data Retention
+---
 
 Coder supports configurable retention policies that automatically purge old
 Audit Logs, Connection Logs, Workspace Agent Logs, API keys, and AI Gateway

diff --git a/docs/admin/setup/telemetry.md b/docs/admin/setup/telemetry.md
@@ -1,4 +1,6 @@
-# Telemetry
+---
+title: Telemetry
+---
 
 > [!NOTE]
 > TL;DR: disable telemetry by setting <code>CODER_TELEMETRY_ENABLE=false</code>.

diff --git a/docs/admin/templates/creating-templates.md b/docs/admin/templates/creating-templates.md
@@ -1,4 +1,6 @@
-# Creating Templates
+---
+title: Creating Templates
+---
 
 Users with the `Template Administrator` role or above can create templates
 within Coder.

diff --git a/docs/admin/templates/extending-templates/devcontainers.md b/docs/admin/templates/extending-templates/devcontainers.md
@@ -1,4 +1,6 @@
-# Dev Containers
+---
+title: Dev Containers
+---
 
 Dev containers extend your template with containerized development environments,
 allowing developers to work in consistent, reproducible setups defined by

diff --git a/docs/admin/templates/extending-templates/docker-in-workspaces.md b/docs/admin/templates/extending-templates/docker-in-workspaces.md
@@ -1,4 +1,6 @@
-# Docker in Workspaces
+---
+title: Docker in Workspaces
+---
 
 There are a few ways to run Docker within container-based Coder workspaces.
 

diff --git a/docs/admin/templates/extending-templates/dynamic-parameters.md b/docs/admin/templates/extending-templates/dynamic-parameters.md
@@ -1,4 +1,6 @@
-# Dynamic Parameters
+---
+title: Dynamic Parameters
+---
 
 Coder v2.24.0 introduces Dynamic Parameters to extend Coder [parameters](./parameters.md) with conditional form controls,
 enriched input types, and user identity awareness.

diff --git a/docs/admin/templates/extending-templates/icons.md b/docs/admin/templates/extending-templates/icons.md
@@ -1,4 +1,6 @@
-# Icons
+---
+title: 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,

diff --git a/docs/admin/templates/extending-templates/prebuilt-workspaces.md b/docs/admin/templates/extending-templates/prebuilt-workspaces.md
@@ -1,4 +1,6 @@
-# Prebuilt workspaces
+---
+title: Prebuilt workspaces
+---
 
 Prebuilt workspaces (prebuilds) reduce workspace creation time with an automatically-maintained pool of
 ready-to-use workspaces for specific parameter presets.

diff --git a/docs/admin/templates/extending-templates/process-priority.md b/docs/admin/templates/extending-templates/process-priority.md
@@ -1,4 +1,6 @@
-# Improving Agent Resiliency
+---
+title: Improving Agent Resiliency
+---
 
 Coder's agent can automatically lower the scheduling priority
 and raise the OOM (out-of-memory) kill score of user processes

diff --git a/docs/admin/templates/extending-templates/provider-authentication.md b/docs/admin/templates/extending-templates/provider-authentication.md
@@ -1,4 +1,6 @@
-# Provider Authentication
+---
+title: Provider Authentication
+---
 
 > [!CAUTION]
 > Do not store secrets in templates. Assume every user has cleartext access to every template.

diff --git a/docs/admin/templates/extending-templates/resource-metadata.md b/docs/admin/templates/extending-templates/resource-metadata.md
@@ -1,4 +1,6 @@
-# Resource Metadata
+---
+title: Resource Metadata
+---
 
 Expose key workspace information to your users with
 [`coder_metadata`](https://registry.terraform.io/providers/coder/coder/latest/docs/resources/metadata)

diff --git a/docs/admin/templates/extending-templates/workspace-tags.md b/docs/admin/templates/extending-templates/workspace-tags.md
@@ -1,4 +1,6 @@
-# Workspace Tags
+---
+title: Workspace Tags
+---
 
 Template administrators can leverage static template tags to limit workspace
 provisioning to designated provisioner groups that have locally deployed

diff --git a/docs/admin/templates/managing-templates/dependencies.md b/docs/admin/templates/managing-templates/dependencies.md
@@ -1,4 +1,6 @@
-# Template Dependencies
+---
+title: Template Dependencies
+---
 
 When creating Coder templates, it is unlikely that you will just be using
 built-in providers. Part of Terraform's flexibility stems from its rich plugin

diff --git a/docs/admin/templates/managing-templates/envbuilder.md b/docs/admin/templates/managing-templates/envbuilder.md
@@ -1,4 +1,6 @@
-# Envbuilder
+---
+title: Envbuilder
+---
 
 Envbuilder shifts environment definition from template administrators to
 developers. Instead of baking tools into template images, developers define

diff --git a/docs/admin/templates/managing-templates/external-workspaces.md b/docs/admin/templates/managing-templates/external-workspaces.md
@@ -1,4 +1,6 @@
-# External Workspaces
+---
+title: External Workspaces
+---
 
 External workspaces allow you to seamlessly connect externally managed infrastructure as Coder workspaces. This enables you to integrate existing servers, on-premises systems, or any capable machine with the Coder environment, ensuring a smooth and efficient development workflow without requiring Coder to provision additional compute resources.
 

diff --git a/docs/admin/templates/managing-templates/image-management.md b/docs/admin/templates/managing-templates/image-management.md
@@ -1,4 +1,6 @@
-# Image Management
+---
+title: Image Management
+---
 
 While Coder provides example
 [container images](https://github.com/coder/images) for

diff --git a/docs/admin/templates/managing-templates/schedule.md b/docs/admin/templates/managing-templates/schedule.md
@@ -1,4 +1,6 @@
-# Workspace Scheduling
+---
+title: Workspace Scheduling
+---
 
 You can configure a template to control how workspaces are started and stopped.
 You can also manage the lifecycle of failed or inactive workspaces.

diff --git a/docs/admin/templates/open-in-coder.md b/docs/admin/templates/open-in-coder.md
@@ -1,4 +1,6 @@
-# Open in Coder
+---
+title: Open in Coder
+---
 
 You can embed an "Open in Coder" button into your git repos or internal wikis to
 let developers quickly launch a new workspace.

diff --git a/docs/admin/users/headless-auth.md b/docs/admin/users/headless-auth.md
@@ -1,4 +1,6 @@
-# Headless Authentication
+---
+title: Headless Authentication
+---
 
 > [!NOTE]
 > Creating service accounts requires a [Premium license](https://coder.com/pricing).