From 788fdcaa96abb22fd5254c86d4dfa33879a3d779 Mon Sep 17 00:00:00 2001
From: "blinkagent[bot]" <237617714+blinkagent[bot]@users.noreply.github.com>
Date: Mon, 2 Feb 2026 23:51:10 +0000
Subject: [PATCH] chore(site): clarify Use permission in workspace sharing
 dropdown (#21861)

## Summary

Updates the description for the "Use" role in the workspace sharing
dropdown to explicitly mention that users with this permission can start
and stop the workspace, not just read and access it.

## Changes

- Updated the "Use" role description from "Can read and access this
workspace." to "Can read, access, start, and stop this workspace."

## Context

This clarification helps users understand the full scope of the "Use"
permission, which includes `ActionWorkspaceStart` and
`ActionWorkspaceStop` as defined in `coderd/database/db2sdk/db2sdk.go`.

---
*Created on behalf of @geokat*

Co-authored-by: blink-so[bot] <211532188+blink-so[bot]@users.noreply.github.com>
---
 .../workspaces/WorkspaceSharingForm/WorkspaceSharingForm.tsx    | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/site/src/modules/workspaces/WorkspaceSharingForm/WorkspaceSharingForm.tsx b/site/src/modules/workspaces/WorkspaceSharingForm/WorkspaceSharingForm.tsx
index bbc70a039d..6760a48d2a 100644
--- a/site/src/modules/workspaces/WorkspaceSharingForm/WorkspaceSharingForm.tsx
+++ b/site/src/modules/workspaces/WorkspaceSharingForm/WorkspaceSharingForm.tsx
@@ -68,7 +68,7 @@ const RoleSelect: FC<RoleSelectProps> = ({
 				<SelectItem value="use" className="flex-col items-start py-2 w-64">
 					<div className="font-medium text-content-primary">Use</div>
 					<div className="text-xs text-content-secondary leading-snug mt-0.5">
-						Can read and access this workspace.
+						Can read, access, start, and stop this workspace.
 					</div>
 				</SelectItem>
 				<SelectItem value="admin" className="flex-col items-start py-2 w-64">