Admin guide
Set up your workspace
Eight short chapters take you from an empty workspace to a running leave system. Shorter than one who-is-off-next-week email thread.
- 1
Invite
Add people one by one or import everyone from a spreadsheet.
- 2
Configure
Tune the leave types Calm Leave already created and attach approvals.
- 3
Protect
Publish policy rules and holidays that guard your calendar.
- 4
Go live
Your team requests time off; approvals run themselves.
Chapter 1
Add your people
Two ways in: create users one at a time, or hand Calm Leave your existing roster and let it build the structure for you. Either way, everyone lands with credentials in their inbox.
For a single hire, use Admin, Users, Add user: name, email, one or more roles (Employee, HR, Ops Head, Company Admin), and optionally the teams and squads they belong to. Calm Leave generates a temporary password and shows it to you once, with a copy button, so you can hand it over on a call if email is not an option.
The Approver role assigns itself
From: Calm Leave
Welcome to Calm Leave
Your account is ready. Sign in with the temporary password below.
[email protected] · ********
You will be asked to set a new password on your first login.
Sent when a user is created, if the welcome email toggle is on for your workspace.
Chapter 2
The smart import
Upload the roster you already have, and Calm Leave reads the org structure out of it.
Bring a CSV, XLS or XLSX file with up to 500 rows and columns for name, email, roles, team and squad. Only name and email are required, and a downloadable template keeps the columns in the order Calm Leave expects.
Team and squad names are matched case-insensitively against what already exists in your workspace, so a row that says engineering lands in the same team as Engineering. Anything new in the file is created on the spot. Squads need a supervisor: tag one row per new squad with SUPERVISOR in the roles column, and that person becomes its supervisor and gains approval rights automatically. Leave that row out, and the admin running the import is assigned instead.
A bad row, whether it is a typo in an email or a duplicate, fails on its own with a per-row report explaining why. The rest of the file imports fine.
| name | roles | team | squad | |
|---|---|---|---|---|
| Alex Chen | [email protected] | EMPLOYEE | Engineering | Platform |
| Maria Lopez | [email protected] | SUPERVISOR | Engineering | Platform |
| Sam Patel | [email protected] | EMPLOYEE | Design | Brand |
| + 21 more rows | ||||
Structure detected for you
Import runs immediately
From: Calm Leave
Welcome to Calm Leave
Your account is ready. Sign in with the temporary password below.
[email protected] · ********
You will be asked to set a new password on your first login.
Sent to every imported user, if the bulk import welcome toggle is on.
Chapter 3
Leave types
Your workspace is not empty; adjust before you create.
Every new workspace starts with two leave types already configured: Annual Leave and Sick Leave. Most admins open this page to tune the numbers, not to start from a blank form.
For each type you control whether it is paid or unpaid, how many days it allocates, how many days carry over and for how many months, how it accrues (manual, monthly or yearly), an optional gender restriction, and whether a doctor's note style attachment is expected.
Already done for you
Annual Leave
21 days a year
Sick Leave
10 days a year
Chapter 4
Approval workflows
Decide who signs off on each leave type.
Every leave type gets a default workflow assembled from steps, and four step types cover almost every approval chain: Team Lead (every team lead of the requester approves), Squad Lead (every squad supervisor approves), HR (any one HR user approves), and Approver Set (a named group you define, where any member can approve).
All required approvers receive the request at the same time. Everyone must approve for it to go through, one rejection closes it, and a person who covers several steps at once only has to approve one time.
Approver Sets are how you model a custom approval group, like a payroll committee. Members carry the Approver role automatically for as long as they are in the set. Attach a workflow to every leave type that needs sign-off.
Annual Leave, default workflow
Team Lead
Every team lead of the requester
HR
Any HR user can approve
Payroll reviewers
Approver Set, any member
Everyone above must approve. A single rejection closes the request, and one person covering several steps only has to approve once.
From: Calm Leave
New approval task: Alex Chen, Annual Leave
Alex Chen requested 4 days of Annual Leave, 22 to 25 March 2027.
Review it in one click.
Sent to every approver the moment a request is submitted. The link opens the request directly.
From: Calm Leave
Your leave request was approved
Your Annual Leave for 22 to 25 March 2027 is confirmed.
Sent to the employee when the last approver signs off.
From: Calm Leave
Your leave request was rejected
Your Annual Leave request for 22 to 25 March 2027 was not approved.
Can't cover Platform that week, three people are already off.
Sent to the employee immediately on rejection.
Chapter 5
Policy rules
Rules are what stand between you and an empty office. Each one prevents a specific incident.
Notice period
Requests must arrive a set number of days ahead of the start date.
Without it: a Friday afternoon request for Monday morning.
Blackout window
Protect a date range like release week. Block requests outright, or allow them with a visible warning, optionally only past a length you set.
Without it: your launch week is also someone's beach week.
Rolling limit
Cap the days someone can take inside any rolling window, like 10 days in 90.
Without it: balances drain in one long stretch.
Monthly cap
Set a maximum number of days per calendar month.
Without it: December disappears.
Yearly cap
Set a maximum number of days per calendar year for a leave type.
Without it: unpaid leave has no ceiling.
Team capacity
Cap how many people from the same squad can be off on the same day.
Without it: both of your two backend engineers get approved for the same week.
Weekday repetition
Stop patterns like five Mondays in a row.
Without it: the long weekend becomes a standing reservation.
Rules apply to every leave type, or only the subset you pick. Edits collect on a draft policy version, and nothing changes until you publish it, which activates the new version atomically. A dry-run tester simulates a request against the draft before anyone is affected.
Blocked
Fix the dates and the verdict updates instantly.
- Requires at least 7 days notice
- Team capacity reached: 2 people from Platform are already off on 12 March 2027
What an employee sees when a rule fires: the exact rule, before they submit.
Test before you publish
Chapter 6
Holidays and off-days
Add public holidays for the year one at a time, a date and a name, or apply the built-in US Federal Holidays preset for the year in a single click.
Company off-days cover ranges like an all-hands week, on top of public holidays.
Weekends, holidays and off-days never count against anyone's balance. The request form excludes them from the day count automatically, and shows how many were excluded.
5 calendar days requested, 4 working days counted, 1 holiday excluded.
Chapter 7
Leave on behalf
Someone calls in sick and cannot log in to request it themselves. HR, Ops Head or Company Admin can file the leave for them from Admin, Leave on behalf: pick the person, the type and the dates.
It is created already approved, skipping the workflow.
The employee is notified in-app and by email, with the name of the admin who filed it, so nothing happens behind anyone's back.
Admin power, admin responsibility
From: Calm Leave
Leave was logged on your behalf
Maria Lopez (HR) logged Sick Leave for you on 3 February 2027.
Sent to the employee whenever an admin files leave for them.
Chapter 8
Go live
You have imported your people, tuned your leave types, wired up approvals and published the rules that protect your calendar. Here is what a workspace ready to go live looks like.
- People imported, teams and squads detected
- Leave types tuned
- A workflow on every leave type that needs sign-off
- Policy rules published
- This year's holidays added
You have seen the admin side
The other half of the story is the 30 seconds it takes your team to request a day off. See exactly what they see, including the instant policy verdict.
Read the employee guideYour workspace is one import away
Start free, upload the roster you already have, and watch the setup checklist fill itself in.
Free for up to 5 people. No credit card required.