Settings map
Settings is where the knobs live. There are fourteen pages in four groups, and you only see the ones your role can open. This is the map. The detail lives in each area’s own article.
Before you start
Section titled “Before you start”- Workspace settings is at the bottom of the workspace sidebar. Admins and the Owner land on General; Members land on Members.
- Preferences is also in the account menu (your name, bottom of the sidebar). Notifications, Account and Billing sit beside it under Personal.
⌘KorCtrl+Kfinds any page you can open: type “billing”, “agents” or “labels” and press Enter. More in Find your way.- Each workspace page shows your role in its heading: Owner access, Admin access or Member access.
Personal
Section titled “Personal”Yours alone. They follow you across every workspace.
| Page | What it’s for | Who sees it |
|---|---|---|
| Preferences | Appearance (light, system or dark); Defaults: Layout (List or Board) and Timezone; Ambient activity: Sidebar counts, Activity in the sidebar, Activity ticker and Celebrations. Each row says whether it applies in This browser or on Every device. | Everyone |
| Notifications | What reaches you and how: in-app notifications, email digests and the Weekly recap email. | Everyone |
| Account | Your name and photo, Sign-in methods, Privacy (product analytics sharing), and Delete account in the Danger zone. | Everyone |
| Billing | Your plan: Free, Solo Pro or Team, the upgrade, checkout and the billing portal. | Everyone |
Appearance, sidebar counts and Celebrations are saved in this browser. Your default layout, the sidebar’s activity rows, the activity ticker and your timezone are saved on your account, so every device (and, for the timezone, your emails) uses them. Details: Notifications, Snooze, Account, export and deletion, Plans and billing.
Workspace
Section titled “Workspace”The workspace itself: its face, its people, its limits.
| Page | What it’s for | Who sees it |
|---|---|---|
| General | Identity: name, description, icon and built-in appearance. Identity history records who changed what, issue number changes included. Data holds Export workspace. The Owner also gets Delete workspace in the Danger zone. | Admin, Owner |
| Members | People, Departed members’ work, Invitations, then Ownership and Leave workspace in the Danger zone. | Everyone. Members see people and their own Leave. |
| Usage | The workspace’s receipt: humans, agent connections, images and, for the Owner, owned workspaces, each against its limit. | Everyone. Read-only for Admins and Members. |
More: Members and invitations, Plans and billing, Account, export and deletion.
Workspace identity
Section titled “Workspace identity”Under General › Identity, set a Name (1 to 100 characters), an optional Description (up to 280) and an optional Icon: Change icon opens the built-in icons and colors and Upload image (PNG, JPEG or WebP, up to 2 MiB), and the built-in icon is what shows when there’s no image. The previews beside the form show the result in the rail, the switcher and All workspaces before you save. Any change raises a bar with Discard and Save changes. Everyone in the workspace sees the result.
The workspace’s address is built from its name plus a short code, like /acme-studio-k3m4x2qwer. Only the short code finds the workspace, so renaming changes the readable part without breaking old links.
How work moves, gets named and gets scheduled.
| Page | What it’s for | Who sees it |
|---|---|---|
| Workflow | Stages (your statuses, grouped along the path an issue takes: Not started, Under way, Finished, and Off the line for Iced and Canceled; each row’s ⋯ menu renames, moves within its group and removes a custom stage; optional Reviewers on review stages are told when work arrives and get Accept and Send back) and, on Solo Pro, Environments under Finished: an ordered list such as Testing, Staging, Production for where finished work has got to, each with optional Approvers who sign off on the issues that land there, what each approver reviews (Set who reviews what: projects and labels, with everything else passed for them automatically) and an optional URL where people can open it. Flag keys lets issues name the feature flag they ship behind. Environments are off until you turn them on. Plus Workflow activity: every stage, environment, sizing, opinion, prompt and default assignee change. | Admin, Owner |
| Issues | Issue numbers (the issue key, where numbering continues and starting over at 1), Sizing (T-shirt, Fibonacci or off) and Suggestions (turn quick capture’s size guesses, label guesses or duplicate hints Off; duplicates covers agents too). | Admin, Owner |
| Labels | Labels (select one to edit it in place), Who can change them for shared labels and views, a link to Saved views, and settings history. | Admin, Owner. Members too, once Who can change them is Every member. |
| Calendar | A ruler of the next 14 weeks (planning months over cycles and cooldowns), then Planning periods (the planning timezone), Cycles (length, start, cycle timezone and cooldown), Adjust dates together, one Calendar history for both, and Pause cycles or Disable cycles in the Danger zone. | Admin, Owner |
| GitHub | Connected repositories and pull requests on issues. | Admin, Owner |
More: Status, Refined and Blocked, Labels, sizes and priority, Views and filters, Cycles, Roadmap, GitHub.
Issue numbers
Section titled “Issue numbers”Under Issues › Issue numbers, the Next issue card shows what the next issue will be called, and updates as you type. Give the workspace a Key so issues read HYD-123 instead of #123: 2 to 6 letters or digits, starting with a letter. Hydrant suggests one from the name (Hydrant → HYD, Launch control → LC); press Use to take it, or type your own. Old keys that still work are listed under the fields. Leave it empty to keep plain #123. The key shows in lists and the board, the issue page and its relationships, Sign-off, confirmations, the command palette, notifications, digest emails and agent prompts.
Changing the key never breaks anything. Every former key keeps working in search, the command palette, /issues/HYD-123 addresses and GitHub links, forever. #123 and plain 123 keep working too.
Next number sets where numbering continues, for example to line up with the tracker you came from. It must be above the last number used, trashed issues included, and at most 1,000,000. Press Save issue numbers; Discard changes puts both fields back. Hydrant asks you to confirm a skip, because skipped numbers are never handed out: you can skip ahead again later, never back. Both changes appear in General › Identity history.
Start over at 1… gives new issues a fresh key that counts from 1, for example HY2-1 after HYD-427. Every earlier issue keeps its name: HYD-427 still finds the same issue in search, the command palette, /issues/HYD-427 addresses and GitHub links, and its old branches and pull requests stay linked. The earlier range is listed under the key. The new key has to be one the workspace has never used. Start over at 1… waits until the workspace has a key, has used at least one number under it and has no unsaved changes; until then the button says why. Hydrant asks you to confirm, because you can’t go back to the old key. Issue links (/issues/428) and plain #428 keep pointing at the same issue as before, so a link you shared never changes meaning. After a fresh start the key can still be renamed, but not cleared.
Agents
Section titled “Agents”What reaches into the workspace, and what it’s told.
| Page | What it’s for | Who sees it |
|---|---|---|
| Agents | Named agents (identities you assign work to), the Default assignee agents route unnamed work to (Admin, Owner), Access (OAuth connections and agent keys), and the steps to connect another agent. With nothing connected yet, the connect steps come first. | Everyone. Members see and revoke only their own access. |
| Playbook | Agent permissions, Agent prompts and Workspace defaults. | Admin, Owner. Agent permissions and workspace defaults belong to the Owner. |
More: Connect an agent, Agent keys, Named agents, Playbook.
The Danger zone
Section titled “The Danger zone”Anything destructive sits in one Danger zone at the bottom of its page, after the everyday settings. Four pages have one:
- Account: Delete account.
- General: Delete workspace.
- Members: Ownership and Leave workspace.
- Calendar: Pause cycles and Disable cycles.
Export isn’t destructive, so it sits above the Danger zone on General, under Data.
What you should see
Section titled “What you should see”A sidebar with Personal, then Workspace, Work and Agents, showing only the pages your role can open. A group with nothing you can open disappears entirely.
If it goes sideways
Section titled “If it goes sideways”- “This section is unavailable with your current access. Your drafts are kept.” That page needs an Admin or the Owner. Ask one, or check your role in Who can do what.
- Labels is missing. You’re a Member and member access is off. An Admin or the Owner can set Labels › Who can change them to Every member.
- General is missing. Members can’t open it. The workspace name and icon are an Admin’s job.
- An old bookmark to a settings page still works. That’s on purpose. Older addresses redirect to the page’s current home: Plan is now Usage, Cycles and Planning calendar are Calendar, and plan and billing links open Billing.
- A preference didn’t follow you to another browser. Appearance, sidebar counts and Celebrations are saved per browser. Set them again there. Your timezone follows you; in Automatic each device shows its own clock.