2026-09-08 12:34:00 -04:00
|
|
|
---
|
|
|
|
|
title: Appearance (Premium)
|
|
|
|
|
---
|
2024-12-17 13:20:01 -05:00
|
|
|
|
2025-03-10 15:58:20 -05:00
|
|
|
> [!NOTE]
|
2025-04-02 16:51:57 -04:00
|
|
|
> Customizing Coder's appearance is a Premium feature.
|
2025-03-10 15:58:20 -05:00
|
|
|
> [Learn more](https://coder.com/pricing#compare-plans).
|
2023-12-28 15:06:54 -06:00
|
|
|
|
|
|
|
|
Customize the look of your Coder deployment to meet your enterprise
|
|
|
|
|
requirements.
|
|
|
|
|
|
|
|
|
|
You can access the Appearance settings by navigating to
|
|
|
|
|
`Deployment > Appearance`.
|
|
|
|
|
|
2024-10-05 08:52:04 -07:00
|
|
|

|
2023-12-28 15:06:54 -06:00
|
|
|
|
|
|
|
|
## Application Name
|
|
|
|
|
|
|
|
|
|
Specify a custom application name to be displayed on the login page. The default
|
|
|
|
|
is Coder.
|
|
|
|
|
|
|
|
|
|
## Logo URL
|
|
|
|
|
|
2024-01-02 14:53:18 -05:00
|
|
|
Specify a custom URL for your enterprise's logo to be displayed on the sign in
|
|
|
|
|
page and in the top left corner of the dashboard. The default is the Coder logo.
|
2023-12-28 15:06:54 -06:00
|
|
|
|
2024-06-04 12:49:13 -05:00
|
|
|
## Announcement Banners
|
2023-12-28 15:06:54 -06:00
|
|
|
|
2024-10-05 08:52:04 -07:00
|
|
|

|
2023-12-28 15:06:54 -06:00
|
|
|
|
2024-06-04 12:49:13 -05:00
|
|
|
Announcement Banners let admins post important messages to all site users. Only
|
|
|
|
|
Site Owners may set the announcement banners.
|
2023-12-28 15:06:54 -06:00
|
|
|
|
2024-06-04 12:49:13 -05:00
|
|
|
Example: Use multiple announcement banners for concurrent deployment-wide
|
|
|
|
|
updates, such as maintenance or new feature rollout.
|
2023-12-28 15:06:54 -06:00
|
|
|
|
2024-10-05 08:52:04 -07:00
|
|
|

|
2023-12-28 15:06:54 -06:00
|
|
|
|
|
|
|
|
Example: Adhere to government network classification requirements and notify
|
|
|
|
|
users of which network their Coder deployment is on.
|
|
|
|
|
|
2024-10-05 08:52:04 -07:00
|
|
|

|
2023-12-28 15:06:54 -06:00
|
|
|
|
|
|
|
|
## OIDC Login Button Customization
|
|
|
|
|
|
2025-06-16 13:18:55 -04:00
|
|
|
[Use environment variables to customize](../users/oidc-auth/index.md#oidc-login-customization)
|
2024-10-05 08:52:04 -07:00
|
|
|
the text and icon on the OIDC button on the Sign In page.
|
2023-04-14 12:28:34 -05:00
|
|
|
|
|
|
|
|
## Support Links
|
|
|
|
|
|
2023-08-23 12:27:57 +03:00
|
|
|
Support links let admins adjust the user dropdown menu to include links
|
|
|
|
|
referring to internal company resources. The menu section replaces the original
|
|
|
|
|
menu positions: documentation, report a bug to GitHub, or join the Discord
|
|
|
|
|
server.
|
2023-04-14 12:28:34 -05:00
|
|
|
|
2024-10-05 08:52:04 -07:00
|
|
|

|
2023-04-14 12:28:34 -05:00
|
|
|
|
2023-12-28 15:06:54 -06:00
|
|
|
### Icons
|
2023-04-14 12:28:34 -05:00
|
|
|
|
2024-01-19 20:10:10 +03:00
|
|
|
The link icons are optional, and can be set to any url or
|
2024-10-05 08:52:04 -07:00
|
|
|
[builtin icon](../templates/extending-templates/icons.md#bundled-icons),
|
2025-10-23 22:26:21 +02:00
|
|
|
additionally `bug`, `chat`, `docs`, and `star` are available as special icons.
|
|
|
|
|
|
|
|
|
|
### Location
|
|
|
|
|
|
|
|
|
|
The `location` property is optional and determines where the support link will
|
|
|
|
|
be displayed:
|
|
|
|
|
|
|
|
|
|
- `navbar` - displays the link as a button in the top navigation bar
|
|
|
|
|
- `dropdown` - displays the link in the user dropdown menu (default)
|
|
|
|
|
|
|
|
|
|
If the `location` property is not specified, the link will be displayed in the
|
|
|
|
|
user dropdown menu.
|
2023-04-14 12:28:34 -05:00
|
|
|
|
2024-01-19 20:10:10 +03:00
|
|
|
### Configuration
|
2024-01-15 05:29:59 -05:00
|
|
|
|
2024-01-20 16:27:28 +03:00
|
|
|
#### Kubernetes
|
2024-01-15 05:29:59 -05:00
|
|
|
|
2024-01-19 20:10:10 +03:00
|
|
|
To configure support links in your Coder Kubernetes deployment, update your Helm
|
|
|
|
|
chart values as follows:
|
2024-01-15 05:29:59 -05:00
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
|
coder:
|
|
|
|
|
env:
|
2024-01-19 20:10:10 +03:00
|
|
|
- name: CODER_SUPPORT_LINKS
|
|
|
|
|
value: >
|
|
|
|
|
[{"name": "Hello GitHub", "target": "https://github.com/coder/coder",
|
|
|
|
|
"icon": "bug"},
|
|
|
|
|
{"name": "Hello Slack", "target":
|
|
|
|
|
"https://codercom.slack.com/archives/C014JH42DBJ", "icon":
|
|
|
|
|
"/icon/slack.svg"},
|
|
|
|
|
{"name": "Hello Discord", "target": "https://discord.gg/coder", "icon":
|
2025-10-23 22:26:21 +02:00
|
|
|
"/icon/discord.svg", "location": "navbar"},
|
2024-01-19 20:10:10 +03:00
|
|
|
{"name": "Hello Foobar", "target": "https://foo.com/bar", "icon":
|
|
|
|
|
"/emojis/1f3e1.png"}]
|
2024-01-15 05:29:59 -05:00
|
|
|
```
|
|
|
|
|
|
2024-01-20 16:27:28 +03:00
|
|
|
#### System package
|
2024-01-15 05:29:59 -05:00
|
|
|
|
2024-01-19 20:10:10 +03:00
|
|
|
if running as a system service, set an environment variable
|
|
|
|
|
`CODER_SUPPORT_LINKS` in `/etc/coder.d/coder.env` as follows,
|
2024-01-15 05:29:59 -05:00
|
|
|
|
2026-07-15 14:07:09 -04:00
|
|
|
```dotenv
|
2025-10-23 22:26:21 +02:00
|
|
|
CODER_SUPPORT_LINKS='[{"name": "Hello GitHub", "target": "https://github.com/coder/coder", "icon": "bug"}, {"name": "Hello Slack", "target": "https://codercom.slack.com/archives/C014JH42DBJ", "icon": "https://raw.githubusercontent.com/coder/coder/main/site/static/icon/slack.svg"}, {"name": "Hello Discord", "target": "https://discord.gg/coder", "icon": "https://raw.githubusercontent.com/coder/coder/main/site/static/icon/discord.svg", "location": "navbar"}, {"name": "Hello Foobar", "target": "https://discord.gg/coder", "icon": "/emojis/1f3e1.png"}]'
|
2024-01-15 05:29:59 -05:00
|
|
|
```
|
|
|
|
|
|
2024-01-19 20:10:10 +03:00
|
|
|
For CLI, use,
|
|
|
|
|
|
2026-07-15 14:07:09 -04:00
|
|
|
```sh
|
2025-10-23 22:26:21 +02:00
|
|
|
export CODER_SUPPORT_LINKS='[{"name": "Hello GitHub", "target": "https://github.com/coder/coder", "icon": "bug"}, {"name": "Hello Slack", "target": "https://codercom.slack.com/archives/C014JH42DBJ", "icon": "https://raw.githubusercontent.com/coder/coder/main/site/static/icon/slack.svg"}, {"name": "Hello Discord", "target": "https://discord.gg/coder", "icon": "https://raw.githubusercontent.com/coder/coder/main/site/static/icon/discord.svg", "location": "navbar"}, {"name": "Hello Foobar", "target": "https://discord.gg/coder", "icon": "/emojis/1f3e1.png"}]'
|
2024-01-19 20:10:10 +03:00
|
|
|
coder-server
|
|
|
|
|
```
|