Settings
Account settings
Your profile, password, linked accounts, sessions, notifications, theme and keyboard shortcuts.
Account settings are about you, not a workspace: they follow you across workspaces and projects.
Where to open them
Section titled “Where to open them”The account menu at the bottom of the sidebar (your name) has:
- Profile and sessions
- Notifications
- a Theme control
- Keyboard shortcuts (not shown on a phone)
- Install app, when your browser can install the dashboard and you haven't yet
- Instance admin, for instance admins only
- Sign out
CommandK also opens any of these pages by name, including Appearance (see Command menu and search). Inside settings, the sidebar lists the section you're in first and open, and the others (Account, Instance, Workspace, Projects) folded below it. The account section holds Profile, Notifications, Appearance and Keyboard shortcuts. Back to … at the top is the way out.
Profile
Section titled “Profile”Details
Section titled “Details”- Display name saves when you confirm it with its check mark ("Name saved").
- Email. With mail set up on the server, changing it sends a confirmation to the new address ("Check … to confirm the change"), and the line "Waiting for confirmation of …" shows until you click the link. Without mail, the field is read-only: only an instance admin can change your email.
- Change picture doesn't upload one. CirCI uses the picture of the account you sign in with, or a generated avatar when that account has none. To change it, change the picture on that account.
Password
Section titled “Password”Shown only when your account has a password. An account that only uses single sign-on has no password. Change password asks for the current password, a new one and a confirmation. A password is at least 12 characters, and changing it keeps this device signed in.
Signed in with
Section titled “Signed in with”The accounts you can sign in with, each marked Linked or Not linked. Link connects a provider the instance offers, and Remove disconnects one (after a confirmation). You can't remove your only way to sign in. Linking GitHub also lets you approve and reject from GitHub checks and pull request comments, as yourself. See GitHub.
Sessions
Section titled “Sessions”Every browser signed in as you, with a description such as "Firefox on macOS", its address and when it signed in. Sign out ends one; Sign out everywhere else ends all but this device, after a confirmation. Ending a session also cuts off its access to hosted sites within a minute.
Notifications
Section titled “Notifications”Everything that needs you lands in the Inbox, and none of it can be switched off. Notifications lists every kind. This page chooses what also reaches you outside the dashboard. Switches save as soon as you flip them, with a toast ("Review requested on, saved").
Only available when the server can send mail. Two switches, mailed to the address shown on the page:
| Switch | Sends |
|---|---|
| Review requested | An email when someone asks you to review a build |
| Review overdue | An email when a review you owe has waited past its target |
Browser or phone notifications for this device, a switch per device. This device shows first, your other devices follow, each with Remove. Below that, choose which kinds to push; the choice applies to every device that is on:
| Kind | Pushes |
|---|---|
| Review requested | Review requests, including again after a push, and overdue reviews |
| Mentioned | Someone @mentions you in a comment |
| Rejected or approved | A build you pushed was reviewed. Rejections include the reason |
Where the browser can't push, the device row says why and what to do. The browser's own permission box only appears after you turn notifications on; if you decline, the browser won't ask again and you change it in its site settings. On an iPhone, notifications work only from the Home Screen, and the page walks you through adding CirCI there. The Reviews page and the Inbox also offer to turn notifications on after a review lands or after your first approval; "Not now" asks again after 14 days, at most three times.
In your Inbox
Section titled “In your Inbox”The page lists the kinds that are always on; Inbox and reviews explains each one. Slack channels for a project are set by an admin in workspace integrations, not here. See Slack.
Appearance
Section titled “Appearance”Theme: System (follows your computer), Light or Dark, each shown as a small preview. It's kept in this browser only, so another browser starts with its own choice. Screenshots under review always show on white. The account menu's Theme control, and CommandK then "theme", change it from anywhere. The change applies at once and needs no Save.
Keyboard shortcuts
Section titled “Keyboard shortcuts”Every shortcut in one page, grouped as in the ? dialog: General, Navigation, Tabs, Lists, Inbox, Build review and Triage. Press ? anywhere to see them. The rows that are a single key are marked.
The Single-key shortcuts switch at the top is on by default. Off, only shortcuts with Command or Option work, so a stray letter can't act on the page. It saves as soon as you flip it ("Single-key shortcuts off") and is kept in this browser only, like the theme. See Keyboard shortcuts. The main ones:
| Key | Does |
|---|---|
| CommandK | Open the command menu |
| ? | Show the shortcut list |
| Command\ | Hide or show the sidebar |
| CommandShiftC | Copy the link to this page |
| gtheni, gthenr, gthenp, gthent, gthens | Open Inbox, Reviews, projects, Triage, Settings |
| j / k, Enter, Space, x, f | Move, open, peek, select, filter in a list |
The full list is Keyboard shortcuts. See Reviewing a build, Inbox and reviews and Triage and flaky screenshots for the keys of each screen.
Install as an app
Section titled “Install as an app”The dashboard can be installed as an app, with its own window and tabs. An offer appears in the Inbox after your second visit or first approval ("Not now" hides it for 14 days, at most three times), and Install app in the account menu is always there while it isn't installed. In the installed app there are tab keys: Alt + t new tab, Alt + w close, Alt + 1 to 9 go to a tab, Alt + p pin. See Mobile and the installed app.