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.

8 chaptersAbout 12 minFor admins and HR
Set up your team in about 12 minutes
  1. 1

    Invite

    Add people one by one or import everyone from a spreadsheet.

  2. 2

    Configure

    Tune the leave types Calm Leave already created and attach approvals.

  3. 3

    Protect

    Publish policy rules and holidays that guard your calendar.

  4. 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

You never assign the Approver role by hand. Anyone who becomes a team lead, squad supervisor, or approver set member gets it automatically, and loses it when they stop being one.
Automated email

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.

Sign in

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.

team-roster.xlsx
nameemailrolesteamsquad
Alex Chen[email protected]EMPLOYEEEngineeringPlatform
Maria Lopez[email protected]SUPERVISOREngineeringPlatform
Sam Patel[email protected]EMPLOYEEDesignBrand
+ 21 more rows
Detected automatically
Engineering team, newDesign team, existsPlatform squad, supervisor: MariaBrand squad, new
24 users created 3 teams, 5 squads createdWelcome emails sent0 errors

Structure detected for you

Teams and squads are created from the spreadsheet itself, so you never build the org chart by hand.

Import runs immediately

There is no preview step, so give the file a quick scan before you upload it. The template download keeps your columns right.
Automated email

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.

Sign in

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

Two starter leave types are pre-seeded. Most teams only tweak the numbers.

Annual Leave

21 days a year

PaidYearly accrual5 days carryover

Sick Leave

10 days a year

PaidAttachment required

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.

Automated email

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.

Review request

Sent to every approver the moment a request is submitted. The link opens the request directly.

Automated email

From: Calm Leave

Your leave request was approved

Your Annual Leave for 22 to 25 March 2027 is confirmed.

View request

Sent to the employee when the last approver signs off.

Automated email

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
4 working days, 1 holiday excludedSubmit request

What an employee sees when a rule fires: the exact rule, before they submit.

Test before you publish

Run the dry-run with a real scenario, like next Monday for someone in Platform, and see exactly which rules would fire.

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.

Friday 25 December 2026, Christmas Day

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

On-behalf requests skip approvals and policy blocks by design. The policy verdict is still shown to you while you file it.
Automated email

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 guide

Your 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.