On deployments without a license, the Network settings page now moves
options that need a license into their own "Premium settings" section.
The section has a Premium badge in its title and the description "These
settings require a Premium license to take effect. Learn more about
Premium". The link goes to the in-product Premium page
(`/deployment/premium`) and only shows when the user can view licenses,
matching the paywall's `canViewPremium` check. With a license, every
option stays in one table in its defined order, the same as before.
Options annotated `enterprise` in `codersdk/deployment.go` count as
needing a license. Proxy Health Check Interval is now annotated
`enterprise` too, because only `enterprise/cli/server.go` reads it. As a
side effect, `coder server --help` lists it under the Enterprise options
group. The golden files are regenerated.
`OptionsTable` gains an optional `aria-label`, so the two tables on the
Network page have names.
[Relates to
DES-22148](https://linear.app/codercom/issue/DES-22148/add-premium-upsell-pills-to-deployment-level-settings).
<img width="6400" height="3270" alt="PR 31460 Before After Network"
src="https://github.com/user-attachments/assets/7ab2a2ec-a54a-42dc-9556-ae8f1964d4a3"
/>
<details>
<summary>Decision log</summary>
- **Block Direct Connections, the example in DES-22148, is not
Premium.** Free code (`cli/server.go`, `coderd/workspaceagents.go`)
reads it with no license check. The "Disabled" in the screenshot is just
its default value (`false`).
- **The existing `enterprise` annotation is the source of truth**, so
the frontend doesn't keep its own list of Premium options.
- **Group by license, with one label per section (designer's call).**
This replaces earlier per-row badges and helper lines, which repeated
the same message on every row and made the default `md` badge look
oversized next to 14px titles. It follows Coder Kit's badge guidance
(Premium is a category label) and the existing h2 `SettingsHeaderTitle`
with a badge on the Security page's Browser-Only Connections section.
The accepted tradeoff: unlicensed, DERP Server Relay URL and Cluster
Host sit apart from the related networking options.
- **With a license, the section disappears** and the options return to
their defined order, so licensed admins see no change.
- **"To take effect", not "to change".** This page is read-only, and the
server accepts these values without a license. The features behind them
are gated: Browser Only stays off and shows a license warning
(`enterprise/coderd/license/license.go:900`), workspace proxies need
`workspace_proxy` (`enterprise/coderd/coderd.go:413`), and multiple
replicas need `high_availability` (`license.go:693`). The wording
follows the docs' "requires a Premium license" pattern.
- **"Learn more about Premium" is an internal link** to
`PREMIUM_PAGE_PATH`, without the external-link icon (designer's call).
It uses `Link asChild showExternalIcon={false}` around a router link, as
elsewhere in the app, and is hidden without
`permissions.viewAllLicenses`, like `PaywallSmall`.
- **The check is any license, not per feature.** Only the Network page
renders `enterprise`-annotated options: DERP Server Relay URL, Browser
Only, Cluster Host and Proxy Health Check Interval.
- **Not annotated in this PR**, because no deployment settings page
shows them: Default Quiet Hours Schedule, Allow Custom Quiet Hours,
Provisioner Daemon PSK and the AI Gateway Proxy options. AI Budget
Policy/Period render only when the AI Governance page is already
entitled.
**Follow-ups**
- Add per-feature checks by putting the feature name in the annotation
and checking `entitlements.features[name].enabled`.
- Give the other `OptionsTable` callers an `aria-label`.
</details>
---
Generated by Coder Agents on behalf of @designertyler.