Luna HR Docs

Onboarding

Getting started with Luna HR takes just a few minutes. This guide walks you through the initial setup process.

Creating your account

When you first sign up for Luna HR, you'll be asked to create your account using your email address. Luna HR uses secure authentication — there are no passwords to remember.

Once signed in, the setup wizard will guide you through configuring your company.

If a company has invited you

Use the link in your invitation email: signing up through it joins that company. Sign up with the email address shown on the sign-up page. For a login invite that is the work address your employer has on record for you. For a link that follows the onboarding wizard (its last slide, the signature email, the next-day reminder) it is the address the wizard was sent to, often your personal one, so you can sign up before your work mailbox exists. Your work address on the record doesn't change.

If you're already signed in to Luna HR with another account when you open an invite link, nothing is added to that account. Luna tells you which company you're signed in to and that the invite is for a different account: sign out, open the link again and sign up with the address the invite names.

If you sign up with a different address (for example by choosing Google with a personal account), Luna cannot match you to the invitation. It creates nothing and tells you so: sign out and sign up again with the address the page names, or ask your HR team for a new invitation. Setting up a new company from that screen is possible, but only if you choose it.

If you sign up without the link and a company has a profile waiting for your address, Luna asks before doing anything: you'll see the company's name and choose Join, or choose to set up a new company instead. Luna never joins you to a company on the strength of your email address alone, so a company you have nothing to do with cannot pull your account into its workspace by adding your address. If more than one company is listed, pick the one you're joining.

If you signed up before your employer invited you, you will have landed in the setup wizard for a new company of your own. Once the invitation exists, the wizard shows it at the top: choose Join and the unfinished company is discarded. This is offered only while that company's setup is unfinished and nobody else has been added to it. The wizard also has a Sign out link at the bottom.

If your sign-in still belongs to a previous job, you will see Your access has ended. When a new employer has invited the same email address, that screen lists the invitation: choose Join and your sign-in moves to the new company. Your old record stays with your previous employer; it simply no longer has a sign-in attached.

The setup wizard

The wizard has four or five steps, depending on the template you pick. Nothing is saved until you choose Create my workspace on the last one, so refreshing the page starts it again from step 1.

1. Your company

Your company name, which part of the UK you are in, and your timezone. Luna HR is set up for UK companies: the currency is pounds sterling and the financial year starts on 1 April (you can change both afterwards in Admin > Company Details).

Where you are decides the default public holiday calendar. Three are created — England & Wales, Scotland and Northern Ireland — and the one you choose is the default your leave policy uses.

2. Choose your modules

All ten modules are ticked to begin with: Leave, Expenses, Training, Security Awareness, Assets, Recruitment, Wellness, Performance, Reports & Analytics and Device Security. Untick the ones you don't need — Leave is the only one that can't be unticked. You can switch modules on and off later from Admin > Modules.

The wizard creates starter data (categories, policies, templates) only for the modules ticked here. See Modules for what happens when you switch one on later.

3. Pick a starting template

There is no org chart to draw in the wizard. You pick the template closest to your organisation and Luna HR creates the structure and settings for it — everything can be changed afterwards.

| Template | Org structure | Leave | Also | |----------|---------------|-------|------| | Startup | Company → one General department | 25 days annual leave with no approval step; sick leave | 9 expense categories; Compliance and Onboarding training categories | | SME | Company → your office → General, Finance and Operations departments | 28 days annual leave with carry-over, approval required; sick leave; leave in lieu | 22 expense categories; 6 training categories, 3 compliance courses and 4 certification types | | Enterprise | Company → a UK & Ireland region → your office → the same three departments | As SME, plus compassionate and parental leave | 22 expense categories with higher claim limits; the same training set as SME | | Field / Frontline | Company → one Operations department | 28 days annual leave, approval required; sick leave | 9 expense categories; phone, headset and uniform asset categories; 4 certification types |

Every template also creates a Monday–Friday working pattern (09:00–17:30, or 08:00–16:00 for Field / Frontline — edit it if your people work shifts or weekends), the current leave year and the next one, HMRC mileage rates, Filing Cabinet categories, a Line Manager Approval workflow for leave, a default onboarding template and four roles (see Company Setup). The expense, training and asset items are only created if that module is ticked.

This step also has the Include demo data switch, which is on unless you turn it off. See Demo data below.

4. Your first location (SME and Enterprise only)

A name and a city for your main site, which becomes the office in your org structure. The Startup and Field / Frontline templates have no office level, so the wizard skips this step for them — add offices later from Admin > Org Structure.

5. Invite your team

Optional. Add up to 10 colleagues by email address, with their first and last name if you have them. When you finish the wizard each one is added to your company as an invited employee on the Employee role and is emailed a sign-up link; signing up through that link joins them to your company (see If a company has invited you).

If Luna HR could not invite someone — the address isn't valid, it was listed twice, or it already has a profile in your company — the final screen lists who was left out and why before you continue to the dashboard.

These are plain sign-up invitations. Colleagues invited here do not go through the new-hire onboarding wizard described below; that is sent from Admin > Onboarding. You can add or import everyone else from Employees afterwards.

After the wizard

You land on the dashboard. Administrators see a Getting started checklist there — add your first employee, set up your org structure, import your data — until every item is done or an administrator dismisses it. Other employees never see it. An invited colleague counts as your first employee straight away; demo people don't.

Luna HR also emails you a welcome message. Teams of five or fewer are on the free plan, and every module except the security add-on stays free for good. A 14-day trial starts when you finish the wizard: a small team uses it to try Luna AI and the security add-on, which are paid extras afterwards, and a larger team needs a subscription when it ends. Luna AI starts switched off for everyone, you included — switch it on for people in Admin > Modules. See Modules for how plans work.

Demo data

With Include demo data on, the wizard adds invented people and records so you can see how Luna HR looks in use:

  • Sample employees — 3 with the Startup template, 8 with SME, 15 with Enterprise, 6 with Field / Frontline
  • Their records, for the modules you ticked — leave requests, expense reports, training records, assigned assets and an example monthly expense budget
  • A few records of your own to try things with, again only for the modules you ticked — a sample laptop, a vehicle for mileage, two expense reports, a wellness survey, a security awareness course and two sample vacancies with candidates (the vacancies are never published to your careers page)

You can tell sample people by their employee numbers (DEMO001 onwards) and their @demo.example.com email addresses. They cannot sign in, they are never counted as billable seats, and they hold the Employee role, so a sample person is never asked to approve a real person's request. Their own pending requests come to you, so you can try approving and rejecting.

While demo data is loaded, administrators see a notice at the top of the app saying so, with a Remove demo data button. The notice can be dismissed for the day, and a billing notice takes its place when there is one; the same button is always on the Demo Data card at the bottom of Admin. Removing it deletes every sample person and record and cannot be undone. Your settings — leave types, policies, org structure, categories — and everything you added yourself stay.

The new-hire onboarding wizard

This is a different wizard from the one above. When you send someone an onboarding invitation from Admin > Onboarding, they receive a personalised onboarding link. The wizard shows these slides, in this order — the template decides which of the optional ones appear:

  1. Welcome — your welcome title and message. Always shown
  2. Your role — job title, department, team, start date and working pattern, read from their employee record. Optional
  3. Key people — their line manager plus any contacts you add to the template. Optional
  4. Meet your team — everyone else in their primary team, line manager first. Optional; skipped when they have no teammates yet
  5. Your office — address, access hours, parking and transport from their office in your org structure. Optional; skipped when that office has no details filled in
  6. Tips — the tip cards you write. Optional
  7. Your first week — the template's checklist, read-only. Shown whenever the checklist has at least one item
  8. Your details — the personal fields you choose (see the Personal fields tab below). Always shown
  9. Emergency contact — name, relationship and phone. Optional
  10. Transport — how they'll commute, parking, and vehicle or cycle details. Optional
  11. Documents — the files you ask them to upload. Shown whenever the template asks for at least one
  12. Your policies — their leave allowance and upcoming public holidays, expense categories and mandatory training, for the modules you use. Optional; skipped when there's nothing to show
  13. Starter pack — company documents an admin has added with Add to starter pack in the Filing Cabinet (the document's ⋯ menu), to open or download. Shown only when there is at least one; nothing is acknowledged or signed here. Only company documents can go in — not one filed against an employee — and only an admin can add them
  14. Complete — submits everything and asks them to create their Luna HR login. Someone who already has a login (an existing employee, or a new hire who signed up first) is told they're done and offered Go to Luna instead

The onboarding wizard is token-based — new hires don't need a Luna HR account to complete it.

The start date shown on the slides comes from the employee record, except a stand-in date: when a Data Import row has no start date, Luna records the import day and leaves it off the wizard, as it does the invite email.

Pressing Continue on the slide before Complete is what submits the wizard. A new hire who leaves and comes back resumes on the slide they were on. If you've since switched that slide off (or it has nothing to show), they resume on the next one, and never on Complete, so nothing is submitted until they press Continue again.

Admin: onboarding templates

Admins can customise the onboarding experience from Admin > Onboarding:

Template builder

Setup creates one template for you, Standard Onboarding, with a short generic checklist, three documents to upload and no tips — it says nothing about your offices or how you work, so edit it before you invite anyone.

Create reusable onboarding templates. Each template has these tabs:

  • Welcome — the welcome title and message on the first slide, plus an internal note only admins see
  • Slides — switch the optional slides on or off, add key people (pick an employee, or type a name, job title and email for someone who isn't in Luna) and write tips (a title, text and an optional category each)
  • Checklist — a "Your first week" list of things the new hire will do once they start (collect a laptop, meet their manager, sign the confidentiality agreement). It appears as a read-only slide after the tips whenever the template has at least one item; nothing is ticked off in the wizard
  • Documents — required documents the new hire uploads (each can be required or optional, limited to certain file types, and allow several files — a driving licence front and back, say), and required signatures: Filing Cabinet documents they're asked to sign. The wizard won't finish while a required upload is missing
  • Personal fields — which groups the Your details slide asks for: name (always), contact details, identity (date of birth and nationality), home address, equality and diversity, dietary requirements, and transport. New templates start with name, contact details and identity
  • Auto-assign — training courses, security awareness courses and asset categories to set up when the new hire finishes (see When the new hire finishes below)

Job title, department, team and line manager are never set in a template — the wizard reads them from the employee's own record.

Text fields have sensible limits: names and titles up to 200 characters, descriptions, messages and tips up to 2,000, and a key person's email must be a real email address.

Managing invites

The admin onboarding page also shows:

  • Invited employees — who has been sent an onboarding link and their completion status
  • Resend / revoke — resend the invite email, or revoke a pending or in-progress invite. Revoking makes the link stop working immediately and discards anything the new hire had uploaded; their employee record is untouched and you can send a fresh invite later. Completed invites can't be revoked
  • Import a spreadsheet — add many new hires at once through Data Import, then send them the onboarding wizard (see below)
  • Preview — see exactly what the new hire will experience before sending the invitation

Many new hires from a spreadsheet

Use Import a spreadsheet on the Active Invites tab (or Admin > Data Import > Employees). Data Import is the one spreadsheet route for people: a file needs only first name, last name and email — employee number, start date, permission role, status, employment type, contract type and FTE are filled in when left out. Nobody is emailed by the import itself; its last step asks what the imported people should receive, and choosing the onboarding wizard sends each person the wizard invite (with the template you pick), to complete before their first day.

Luna sends at most 500 invitation emails a day per company, so for a bigger import the first 500 are offered and the rest can be invited from Employees the next day. See Data Import for the columns and checks.

How invites work

When you create an onboarding instance, Luna HR:

  1. Generates a unique, secure token for the new hire
  2. Sends an invitation email with the onboarding link (unless the Onboarding invite email is switched off under Admin > Email templates — then copy the link from the invites list and send it yourself)
  3. The new hire clicks the link and completes the wizard at their own pace — answers are saved as they go, and the same link reopens where they left off until they finish or it expires (30 days)
  4. The invites list shows each invite's status — pending, in progress, completed or expired — with its expiry date. It doesn't show which slide someone has reached
  5. On completion, their employee record is updated with the information they provided, and the link stops working

Sending a new invite to someone who already has one replaces it. The old link stops working, and anything the new hire had typed or uploaded through it is deleted; the new invite starts afresh. An invite that expires after 30 days is cleared the same way overnight, and your admins are told in the app. Anyone who opens an expired or replaced link is told to use the newest onboarding email they have or to ask you for a new invite. Resend uses the same email template and wording as the first send, and is refused while that email is switched off. It sends a new link that works for the full 30 days the email promises, and the link sent before stops working — so if the first invite went to a mistyped address, correcting the address and resending is enough. Anything the new hire had already filled in is kept, and the new link opens where they left off. Resend is refused for someone who has since been suspended, set inactive, or started leaving.

An invite link also stops working if the person is suspended, set inactive, archived or becomes a leaver before finishing. Invites are sent to the personal email address on the employee record if there is one, otherwise the work address; an address the new hire types into the wizard does not change where later invites go.

Uploads through the link are limited to 10 MB each and to the file types the document slot accepts (a profile photo must be an image). Replacing a file deletes the one it replaces, and files uploaded through an invite that is revoked, replaced or runs out are deleted. Once the wizard is finished, its answers are held on the employee record only.

When the new hire finishes

Completing the wizard:

  • Updates their employee record with what they entered — name, contact details, date of birth, address, equality and dietary answers, commute preferences and their profile photo — and saves their emergency contact and any vehicle they gave
  • Files every upload in the Filing Cabinet against their profile, tagged onboarding
  • Creates a signature request for each required signature and emails it to them (unless the Signature request email is switched off). Because they have no login yet, the email links to sign-up with the address the wizard was sent to filled in; the document is waiting in their Filing Cabinet once they're in
  • Enrols them on the next scheduled session of each auto-assigned training course — or, when none is scheduled, tells everyone who approves training that they need one
  • Assigns each auto-assigned security awareness course
  • Tells everyone who manages assets which equipment categories they need
  • Emails and notifies their line manager, and notifies your admins in the app

It does not make them an active employee on its own. The last slide asks them to create their Luna HR login with the address the wizard was sent to; signing up from there (or from any invite email) links that login to their record at your company. If they sign up some other way, they are shown your company's name and asked to confirm before joining. Nobody is sent separate login details. If they still haven't signed up about a day after finishing, Luna emails them one reminder with a sign-up link, to the address the wizard went to — that's the Login invite email under Admin > Email templates, so switching it off stops the reminder too.

Email addresses are the link to a login. Luna matches the verified address on the account the new hire creates against the work address on the employee record. When they arrive through one of your links, the address a live or finished onboarding invite for that record was sent to also counts. A revoked, replaced or expired invite doesn't, and nor does an address typed into the wizard. Their work address on the record stays as it is. Luna stores every address lower-cased and compares them that way, so casing in an imported spreadsheet or in the Add Employee form makes no difference.

Employees who have left (leaver, terminated, or archived) or been parked (inactive, suspended) can't be sent a login invite or an onboarding invite — whether from the invite dialog, the No invite yet tab or the Add Employee form. Reactivate them first if that's genuinely what you want.

Next steps

Once your company is set up: