From be184a0591aae9a79d08e98a5f1d9e643bcdb9e3 Mon Sep 17 00:00:00 2001
From: TJ <tracy@coder.com>
Date: Tue, 26 May 2026 12:03:29 -0700
Subject: [PATCH] fix(site): update providers description with BYOK docs link
 (#25680)
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

> 🤖 Generated with [Coder Agents](https://coder.com/agents) on behalf of
@tracyjohnsonux

Updates the providers page description to explain that providers power
Coder Agents, AI Gateway, and other LLM features. Adds a "Manage
deployment-wide BYOK" link to the docs.

Uses `<Link>` component and `docs()` helper per project conventions.
---
 .../ProvidersPage/ProvidersPageView.tsx         | 17 +++++++++++++----
 1 file changed, 13 insertions(+), 4 deletions(-)

diff --git a/site/src/pages/AISettingsPage/ProvidersPage/ProvidersPageView.tsx b/site/src/pages/AISettingsPage/ProvidersPage/ProvidersPageView.tsx
index dde7c8757b..d507d8fcd2 100644
--- a/site/src/pages/AISettingsPage/ProvidersPage/ProvidersPageView.tsx
+++ b/site/src/pages/AISettingsPage/ProvidersPage/ProvidersPageView.tsx
@@ -1,5 +1,5 @@
 import { ChevronDownIcon, PlusIcon } from "lucide-react";
-import { useNavigate } from "react-router";
+import { Link, useNavigate } from "react-router";
 import type { AIProvider } from "#/api/typesGenerated";
 import { ErrorAlert } from "#/components/Alert/ErrorAlert";
 import { Button } from "#/components/Button/Button";
@@ -26,6 +26,7 @@ import { TableLoader } from "#/components/TableLoader/TableLoader";
 import { addableProviders } from "#/pages/AISettingsPage/ProvidersPage/components/addableProviderTypes";
 import { ProviderIcon } from "#/pages/AISettingsPage/ProvidersPage/components/ProviderIcon";
 import { ProviderRow } from "#/pages/AISettingsPage/ProvidersPage/components/ProviderRow";
+import { docs } from "#/utils/docs";
 
 interface ProvidersPageViewProps {
 	isLoading: boolean;
@@ -82,9 +83,17 @@ const ProvidersPageView: React.FC<ProvidersPageViewProps> = ({
 			<SettingsHeader actions={<AddProviderDropdown />}>
 				<SettingsHeaderTitle>Providers</SettingsHeaderTitle>
 				<SettingsHeaderDescription>
-					Connect third-party LLM services like OpenAI, Anthropic, or Amazon
-					Bedrock. Each provider supplies models that users can select for their
-					conversations.
+					Connect third-party services like OpenAI, Anthropic, or Amazon
+					Bedrock. Providers configured here power Coder Agents, AI Gateway, and
+					other capabilities such as APIs, CLI or IDEs that use LLMs. By
+					default, users can supply their own keys for any provider.{" "}
+					<Link
+						to={docs("/ai-coder/ai-gateway/auth#enable-or-disable-byok")}
+						target="_blank"
+						rel="noreferrer"
+					>
+						Manage deployment-wide BYOK
+					</Link>
 				</SettingsHeaderDescription>
 			</SettingsHeader>
 			{Boolean(error) && (