HRMS Guide All guides ↗
Part 1 of 5

Settings — set up your workspace

Almost everything in this part lives under the Settings menu at the bottom of the left-hand menu. You do it once, and it powers the whole app — who you are, how your company is organised, and the rules for attendance, leave, expenses and pay. Each step says who can open it; most of Part 1 is for the company owner and admins.

1

Tell the system about your company

Your name, country, time zone, currency and legal details — the foundation everything sits on.

~5 minDo this onceOwner & admins
Settings › Company › Company Profile
  1. Open Settings, then Company, then Company Profile, and click Edit Profile (top right).
  2. Check your Company Name, Timezone, Currency, Date Format and Time Format.
  3. Under Registration & Legal, add your registered name and tax numbers. For an Indian company that's GSTIN, PAN Number and TAN Number — the fields change to suit your country. Not GST-registered? Leave GSTIN blank.
  4. Fill in Contact (a contact name is required) and the Registered Address — this is where you pick your country, state and city.
  5. Under Employment, decide whether to Confirm employees automatically when their probation ends. Leave it off to confirm each person yourself — you'll get a monthly reminder of probations ending.
  6. Click Save.
💡Why this matters — your time zone and currency decide how every date, time and amount appears — on payslips, reports and the attendance register. Getting them right now saves fixing figures later.
🧾Running payroll in India? Payroll warns you if the company's TAN or an employee's PAN is missing, because they go on Form 16 and the quarterly TDS return. Add them now so your first payroll run is clean.
2

See your plan & what's included

A quick look at which features your subscription unlocks — so nothing surprises you later.

~2 minOwner & billing owner
System › Billing
  1. Open System, then Billing. You'll see your plan, its status, how many employees it covers and when Renewal Due falls.
  2. Note the renewal date. Renewal is manual — there's no automatic charge — so pay before that date to keep access.
  3. Past invoices are under Invoice History, ready to download.
🔒Seeing a padlock in the menu? That feature isn't in your plan — that's normal, not a fault. Opening it shows Upgrade required with a View plans button. The essentials (company, people, settings) are always there.
✅Throughout this guide — features that aren't in your plan still show in the menu, with a padlock. If a step mentions a screen that is missing from your menu altogether, your role doesn't include it.
3

Add your logo and colours

Put your company's logo on the app.

~3 minOptionalOwner & admins
Settings › Admin › Branding
  1. Open Settings, then Admin, then Branding.
  2. Upload your logo — a PNG or SVG with a transparent background looks best.
  3. Pick a primary and secondary colour (or type a colour code like #0c056d), then click Save Branding.
🎨Good to know — your logo shows across the app straight away. The colours are saved for later. Right now they don't change the app or your documents. Nice to have, not essential — come back anytime.
4

Add your offices

List the places your company works from — head office, branches, plants or sites.

~5 minOwner & admins
Settings › Company › Locations
  1. Open Settings › Company › Locations and click Add Location.
  2. Give it a Location Code and Location Name (e.g. "GGN-HQ" / "Head Office"), then pick the country, state and city and its time zone.
  3. Tick Head Office for your main office (and Registered Office if it's your legal address).
  4. In Tamil Nadu you'll also be asked for the Local body (for Professional Tax) — pick it so the right Professional Tax applies. Elsewhere there's nothing extra to choose.
  5. Click Add, and repeat for each office.
💡Why this matters — every employee must have a work location. It decides their country for payroll, which Professional Tax applies, their holidays and local time — and you can run payroll for one office at a time.
🏢Only one office? Add that one and move on. Removing a location later only deactivates it — history is kept. Each location also has a Weekly offs option, explained in Step 7.
5

Build your company structure

Your seniority levels, departments and job titles — like drawing your org chart. Do the three parts in this order.

~10 minOwner & admins

Part A · Seniority levels

The rungs of a ladder — generic words like Director, Manager, Executive. Not job titles.

Settings › Organization › Hierarchy
  1. Open Settings › Organization › Hierarchy. The first time, you're asked for a Hierarchy name — "Corporate" is fine.
  2. Click Add Level and type a name (the code fills itself in). New levels go to the bottom.
  3. Use the up/down arrows to put them in order. The top of the list is the most senior — there's no number to type.
💡Why first? Job titles attach to levels, so levels must exist before Part C — the level picker is empty until you add them.

Part B · Departments

Your teams — Engineering, Sales, HR, and so on.

Settings › Organization › Departments
  1. Click Add Department and enter a Name and Code (e.g. "Engineering" / "ENG").
  2. Making a sub-team? Pick its parent department and it nests underneath.
  3. Optionally pick the department's Head. The Head can be one of the approvers for payroll items such as incentives and reimbursements (Step 9). It's the same Head you see on Settings › Responsibilities (below).
✅Tip — you can add the Head later, once your people exist (Part 2).

Name who is responsible for each department

One list of approvers that both expense claims and payroll inputs use.

Settings › Responsibilities
  1. Under Whole company, name the Finance Head and CFO — the final approvers for money.
  2. Under Departments, name each department's Department Head, HR Manager and Finance Manager: click Name, pick the person and the date they took over, and save. Keep Also covers sub-departments ticked so its sub-departments without their own person use this one.
  3. Under Cost centres, you can name a Finance Manager for each cost centre later, once your cost centres exist (Part 2).
🙋Good to know — Change names a successor (the old holder hands over the day before) and End removes someone today. A Gaps warning at the top lists approval levels that are switched on with nobody who can approve. Naming people needs the owner, a Tenant Admin or an HR Admin.
✅Only the owner — can let an HR Manager or Attendance Supervisor also look after another department (Also look after its people). By default an HR Manager sees only their own department. More on looking after a department.

Part C · Job titles

The titles people hold, like "Software Engineer" or "VP Sales".

Settings › Organization › Designations
  1. Click Add Designation, enter the title and a code.
  2. Pick the seniority level (from Part A) it belongs to. Many titles can share one level — VP Engineering and VP Sales both sit on "VP".
6

Choose your employee ID format

How employee ID numbers look. Set this before you add people.

~2 minOptionalOwner & admins
Settings › Admin › Emp. Codes
  1. Open Settings › Admin › Emp. Codes. A ready-made series is already there, with a Next preview such as EMP-00001.
  2. Click the pencil to change the Prefix, Separator or Digits, then Save. The Next preview shows the new format once saved.
  3. Want contractors numbered differently from staff? Click Add Series, then under Employment Type → Series point each employment type at a series and click Save Assignments.
🔢Set it before you hire — every new person gets the next ID automatically, and an ID never changes after it's given. A change here only affects people you add afterwards.
7

Set your attendance & leave rules

Working hours, holidays, time off and how check-ins work — so they run themselves. Most screens are under Settings › Time & Leave.

~20 minOwner & admins (HR Admins can manage shifts)

Shifts — do this first, it's required

Settings › Time & Leave › Shifts

A shift is a working-hours window, like 09:30 – 18:30. Every employee must have a shift — you pick one when you add each person, and you can't add anyone until at least one shift exists.

  1. Click Add Shift. Give it a Name and Code and set the start and end time. Any break is part of the window — nothing is deducted.
  2. Set Grace Minutes — how late someone can arrive before they're marked late.
  3. For hours that cross midnight (e.g. 22:00 – 06:00), tick Night shift.
  4. Optionally keep the shift for one Office Location or Department — then it can only be given to people there. Leave both on "All" to use it for anyone. Click Create.
👥Giving people their shift — new joiners get one on the Add Employee form. To change someone later, use their profile. Below the shift list you'll also see Without a shift (late marks aren't checked for these people) and Needs review (their department or location changed). Tick people, choose a shift and a From date, and click Assign to… — or click Keep to confirm their current shift.
🗓️Weekly offs — rest days default to Sunday. You can set different ones for a location, a department or a shift (use the Weekly offs calendar button on a location or department row, or Weekly offs in a shift's row menu), including patterns like the 2nd and 4th Saturday. The most specific wins: shift, then department, then location.

Holidays

Settings › Time & Leave › Holidays
  1. Check the Holiday Year card at the top (usually January to December).
  2. Click Import national holidays to preview your country's public holidays for a year and add them in one go — dates you already have are skipped. Or use Add Holiday for one at a time, or Import CSV for your own list.
  3. Set each holiday's scope: all locations, one country, or one office.
  4. Optional holidays (festivals people choose from): tick Optional holiday on the holiday, then under Optional Holiday Pools click New Pool and set a name, year and the Quota — how many each employee may pick. Every optional holiday of that year (and that office, if the pool has one) belongs to the pool automatically. Tick Require approval if picks should be approved (this needs an active Optional Holiday workflow).
📅Good to know — regular holidays aren't working days, so they never count as an absence. Deleting a holiday removes it permanently, and you can't delete one once attendance has been marked for that day.

Leave types

Settings › Time & Leave › Leave Types
  1. Set the Leave Year at the top (India usually April to March).
  2. Quickest start: click Add recommended to create the standard set (Earned, Casual, Sick, Maternity, Paternity…), then edit the quotas.
  3. To add one yourself, click Add Leave Type and pick the kind of leave first — it fills in sensible rules. Earned, Casual and Sick are prorated for people who join mid-year; Maternity, Paternity and similar give the full quota. Then set the Annual Quota (days).
  4. Decide During probation: Accrues and can be taken, Accrues, but cannot be taken yet, or Does not accrue at all. For prorated leave you can also set a lower Quota while on probation. Decide During notice period too.
  5. Finish with the switches — Carry Forward, Encashable, Paid Leave — and save. (Every leave request goes to approval.)
  6. When your types are ready and your people are added, click Initialize balances to give everyone this year's balance.
🔁Comp-off — to give time back for working a rest day, create a Compensatory Off type. Each comp-off is granted one at a time and expires on its own: choose A set time after it is earned (e.g. 90 days) or At the end of the leave year. You connect it in Rest-Day Work below.
✨Automatic after this — new joiners get their balance when they're hired. Maternity and Paternity are limited to the right gender automatically.

Attendance policies — late, half-day, absent, and overtime

Settings › Time & Leave › Attendance

The shift says when people work; the policy says what the rules are. Start with one policy for the whole company and add others for a location, department or shift only if they differ.

  1. Click Add Policy and give it a Policy Name and Policy Code.
  2. Fill only the rules you want — a blank rule is switched off, except Grace period, which can't be blank (enter 0 to use each shift's own grace). Arrival: Grace period (min), Half-day if later than (min), Half-day if leaving early (min). Hours: Full-day hours and Absent if worked under (min). Late marks per absent turns repeated lateness into an absence.
  3. Choose Shortfall handling: Advisory (shortfalls are shown but pay isn't cut) or Enforced (loss of pay — or Deduct leave, then loss of pay).
  4. Pick Mobile Check-in — Restricted (only people mapped to a site, inside its fence), Audit (record where people check in from, refuse nobody) or Open (anyone, from anywhere). New policies start Restricted. See Mobile Check-in below.
  5. Set Applies to — Organization-wide, or one location, department or shift — and save.
💡Overtime is off until you switch it on. Set Overtime after (hours) and Overtime rate (×) and extra hours are recorded on each day. They're only paid once you also tick Pay overtime in payroll (this needs Full-day hours set). Even then, each month a payroll approver reviews every employee's overtime and chooses to pay it or not before payroll runs (Step 18).
✅Tip — start with Advisory for a month to see the effect, then switch to Enforced at the start of a pay month — never halfway through.

Mobile Check-in — where people may check in from their phone

Settings › Company › Mobile Check-in
  1. Click Add Site. Give it a Site Code and Site Name, find the place (search an address or paste a Google Maps link) and set the Fence Radius (m) — how far from the pin a check-in still counts.
  2. On the site, use the … allowed to check in here link to choose who may mark attendance there.
  3. For people who genuinely work anywhere, use Allow someone to check in from anywhere.
⚠️Use Audit before Restricted. Under Restricted, a person with no site mapping can't check in from a phone at all — and a day with no check-in becomes an absence, then a pay cut. Audit shows you who would have been refused without refusing anyone. The page warns you about everyone who has no mapping yet.

Rest-Day Work — what someone gets for working a week off or holiday

Settings › Time & Leave › Rest-Day Work
  1. Each attendance policy is a row. Click Configure.
  2. Set Working a week off and Working a holiday separately: Not compensated (the default), Earns a comp-off, or Paid as overtime.
  3. If you choose comp-off, pick which comp-off leave type to credit (create one under Leave Types first).
🙋How employees use it — they ask from the On Duty tab on the Attendance page (or the mobile app), ideally in advance, and their manager approves. Claims after the day are allowed unless you switch off Allow claims after the day in the same dialog, which also has Employees may claim, Pay multiplier and Requests expire after. Once approved and the day has passed, it's compensated automatically.
Timesheet activities

Only if your people log time. Click Add Activity, give it a Label and Code, and optionally keep it to one department.

Settings › Time & Leave › Timesheet Activities
Attendance devices

Using fingerprint, face or card machines? Click Add Device, pick the type and protocol, and copy the key shown — it's shown only once. Owners, admins and HR Admins see this page.

Time & Attendance › Devices
8

Set your expense rules

What people can claim, and who signs it off.

~7 minIf you manage expensesOwner, admins & HR AdminsExpense plan feature

Expense categories

Settings › Expense › Categories
  1. Click Add Category and enter a Category Name and Category Code — Travel, Meals, Supplies.
  2. Optionally set a Monthly Limit and Annual Limit (in your company currency).
  3. Tick Requires Receipt to make people attach a bill, then save. Every claim goes through the approval levels you set below, whatever the category.

Expense approval levels

Settings › Expense › Approval
  1. Under Approval Levels there are five levels in order: Reporting Manager, HR Manager, Finance Manager, Finance Head and CFO. Switch on the ones you use (Active) and give each an amount range — e.g. Reporting Manager for any amount, Finance Head from 25,000. Click Save Levels.
  2. This page sets the amount bands only. The people who approve are named on Settings › Responsibilities (Step 5) — the Open Responsibilities button under Approvers takes you there.
💡A level is never skipped. If a claim needs a level nobody holds — or the employee has no reporting manager — the claim is refused when submitted and says what to fix. A warning at the top of the page lists any gaps. You'll fill in the people once they exist (Part 2).
🙋Claims in another currency are converted to your company currency before the amount bands are checked. If no exchange rate is set for that currency, the claim is refused with a clear message. Exchange rates are kept by Verdeshell — contact Verdeshell support if a currency you use is missing.
9

Set your tax & statutory (payroll) rules

PF, ESI, Professional Tax, income tax, and the company rules payroll follows. Most screens are under Settings › Finance.

~15 minIf you run payrollOwner, HR Admins, Finance & Payroll AdminsPayroll plan feature

Statutory — PF, ESI and Professional Tax

Settings › Finance › Statutory
  1. Provident Fund tab: click Add config, pick the country, and check the employee and employer rates, wage ceiling and start date. For India the usual figures are suggested for you — your company decides the final ones. Save.
  2. ESI tab: the same — Add config, review the suggested rates and wage ceiling, save.
  3. Professional Tax tab: nothing to set up for most states — Verdeshell keeps each state's rates up to date (see the reference table at the bottom) and uses each employee's work location. Use Add registration to record your PT registration number for each state; it prints on the Professional Tax report. Use Add slab only for a state that's missing, or for Tamil Nadu offices outside Greater Chennai.
🧮Income tax (TDS) needs no setup. It's worked out and deducted on every payslip automatically from the tax rules Verdeshell maintains, plus each employee's own tax declaration. Just make sure your company's TAN and PAN (Step 1) and each employee's PAN are filled in.
📆When rates change, add a new configuration with the date it starts — earlier months keep their old figures. Once payroll has processed a month with a setting, you can't edit it; add a new one instead.

Payroll Inputs Approval — who approves incentives, bonuses, reimbursements and deductions

Settings › Finance › Payroll Inputs Approval

"Payroll inputs" are the one-off amounts added to a month's pay: Incentive, Bonus, Variable pay, Reimbursement and Deduction. Every approval level starts switched off. With none on, one Finance or HR Admin approves each item — never the person who entered it.

  1. Who can enter: click Add to map HR Managers and HR Executives to the departments, cost centres or whole company they handle. Until they're mapped they can't enter anything. HR Admins, Finance and the owner can always enter for everyone.
  2. Approval levels: open each type's tab, switch on the levels you want (Reporting Manager, Department Head, HR Manager, Finance Manager, Finance Head, CFO) with an optional amount range, and click Save … levels.
  3. Approvers: there's no separate list here any more. The same people named on Settings › Responsibilities (Step 5) approve both payroll inputs and expense claims. The Department Head (named there, or on each department) approves payroll inputs only.
🧷Rules people trip over — the amount range is checked against the employee's total of that type for the month, so splitting an amount doesn't avoid a level. A level is never skipped: if nobody holds it, the item is refused with a note saying what to fix. Someone holding two levels approves once.
Base Days

What a month's salary is divided by to price one day: the Calendar month, a 30-day month or a 26-day month. The same day-rate is used to cut a day of unpaid leave and to pay a worked rest day. Applies from the next payroll run.

Settings › Finance › Base Days
Leave Encashment

How cashed-out leave is paid: a day is a share of gross or Basic pay, divided by the calendar month, 30 or 26. With nothing saved, payroll uses gross ÷ 30. Add a country or office rule where it differs.

Settings › Finance › Leave Encashment
Opening Income Tax

Started using Verdeshell partway through the financial year? Enter each person's taxable salary and TDS from the earlier months so tax isn't collected twice. The same page sets the tax-declaration window and proof deadline.

Payroll › Payroll › Opening Income Tax
10

Review your roles

Roles decide what each person can see and do. You'll hand them out in Part 2 — here you just look at what each one can do.

~5 minOptionalOwner & role admins
Settings › Admin › Roles
  1. Open Settings › Admin › Roles to see every role — ready-made ones such as HR Admin, HR Manager, Manager, Finance Approver, Payroll Admin and more.
  2. Click View Permissions to see exactly what a role allows and how far each part reaches: Self, Direct Reports, All Reports, Department or Organization.
🧩Roles are fixed — Verdeshell sets them up and keeps them up to date. You can't create new roles or change what a role allows; this screen is for looking only. To change what someone can do, give them a different role. A person can hold more than one role, and they get everything all their roles allow — so give the smallest role that covers the work. You give roles to people in Step 16.
✅HR Managers — see and act on their own department only, by default. The owner can let them look after more departments on Settings › Responsibilities (Step 5).
11

Set up your letter & exit templates

Ready-made wording for the letters you send often, and the checklist people clear when they leave.

~5 minOptionalHR Admins, HR Managers & owner (Clearance: owner & admins)
Letter templates

Click Add standard templates for a ready set, or New Template to write your own — click a fill-in field, like the employee's name, to drop it in. Later, Generate a letter for any employee as a PDF; tick Require employee acknowledgement if they must accept it in My Letters.

System › Letter Templates
Clearance (exit checklist)

Click Add Template, pick which team owns the item (IT, Finance, HR, Security, Admin, Reporting Manager…), name it — e.g. "Return laptop" — and set its order. Every leaver's checklist is built from these. It sits under Settings › Admin, which only the company owner and admins see in their menu.

Settings › Admin › Clearance
📄Both are easy to add later — set them up when you start hiring or handling exits. Clearance needs the Offboarding feature in your plan.
12

Email & automation

A few extras — set them now or come back later.

WheneverOptional

Send email from your own address

Settings › Admin › Email

Out of the box, emails (invites, payslip notices, reminders) come from Verdeshell — that works fine. To send from your own domain instead:

  1. Pick your email provider (Brevo, SendGrid, Postmark, Mailgun, Resend, AWS SES, Microsoft Graph or Google Workspace) and paste the key it gives you.
  2. Set the From email and name, click Save Configuration, then Send Test Email to check it works.
  3. Changed your mind? Revert to Platform Default switches back at any time.
✅Tip — verify your sender domain with the provider first, and keep an eye on its sending limits. Owner and admins only.

Notification preferences — each person chooses

System › Notif. Preferences

Every user can turn Push Notifications (mobile app) and Email Notifications on or off, and switch individual events on or off, then click Save Preferences. It only changes what they receive.

🔔In-app notifications (the bell) are always kept, and some security and statutory notices can't be switched off. Point your team here if they ask.
Cover when someone's away

Any approver can hand their approvals to a colleague for set dates: New Delegation, pick the person, dates and scope, then Create Delegation. "All" doesn't cover payroll inputs — choose Payroll inputs for those.

Operations › Delegations
Custom approval flows

Need approvals with extra steps or special rules? Build your own. The built-in flows suit most companies.

Operations › Workflows