# HR

Keep every employee record in one place, onboard new hires, track trainings and time off, and handle HR requests.

When a new machinist starts at Acme Precision, someone has to collect the signed forms, set up an email and a badge, assign the safety trainings and track the first week off they ask for. HR keeps that work in one place: requests to HR, the employee roster, onboarding documents, trainings and certificates, time off, hiring and, when you turn it on, payroll.

[Add it from the Marketplace](/tenant/?open=settings/marketplace)

## What it does

The module adds these pages under **HR** in the sidebar. Each person sees only the pages their role allows.

- **Requests** (*Onboarding & Requests*): the request tiles (**New Hire & Onboarding**, **General HR Request** and **Training Assignment Request**), **My Requests** with everything you have sent, and **Open board →** for the people who work HR's requests.
- **Employees**: the roster. The tiles count **Employees**, **Onboarding**, **Needs login** and **Active**; the **Stage** and **Outstanding** columns show how far each person is and what they still owe. **Org chart** and **PTO** are buttons at the top. Click a person to open their record, with the tabs **Profile**, **Onboarding**, **Employee files**, **Training**, **Assets & access**, **Benefits** (**Pay & benefits** for people who may see pay), **PTO** and **Reviews & forms**.
- **Onboarding Tasks**: the company items and access to hand out to new hires, such as a building badge or an email account.
- **Employee Portal**: each person's own **My Onboarding**, **My Profile**, **My Training**, **My Documents** and **My PTO**. Managers also get **Approvals** and **My Team**.
- **Careers & Recruiting**: **Job Postings** for your careers website, and **Candidates** who applied.
- **Payroll**: pay periods, time import and export to your payroll service. It shows only when Payroll is turned on.
- **Reports**: the ready-made **Employee roster** and **Employee review** reports.

## Set it up

A Workspace Admin does this first.

1. Open **Module Settings** from the ⋮ on the **HR** sidebar row, and go to **Configuration**. See [Module settings and versions](article:fb7c92e4-6dcc-4ef4-80bc-1b6e7482e540).
2. On **Lists & Departments**, fill in the **Code lists**: departments, locations, employment types, the new-hire **HR checklist**, **Issued assets & access** and training categories. Add your **Labor roles**, and under **Request board access** add the people who work HR's requests as an **Agent** (or only see them as a **Viewer**).
3. On **Documents**, add your onboarding documents and place their signature fields. On **Trainings**, add each training and set **Certificate branding** (company name and logo).
4. On **PTO**, set the waiting period and whether people may ask for more than their balance, and click **Save**. The PTO groups, accrual rates, smallest request and paid sick leave are on the **Preferences** tab.
5. On **Benefits** and **Careers**, add the benefits library and your careers website settings, if you hire online. Your website reads jobs and sends applications in with an API key that has only the careers website permission.
6. To run payroll here, turn Payroll on in **Preferences**, then pick the time source and the payroll target on **Payroll → Setup**.
7. Add your current employees (see below), set each person's **Reports to**, and give each a portal login.
8. Give the permissions to your own roles, such as HR Manager or Supervisor. Only the standard Admin, Operator and Viewer roles get them automatically. Give **See and change pay** only to HR and payroll. See [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f).

## Send HR a request

1. Click **HR**, then **Requests**.
2. Click the **General HR Request** tile.
3. Type the **Subject**, pick the **Priority** and write the **Description**.
4. Click **Submit Request**, or **Save Draft** to finish it later.
5. Follow it under **My Requests**. Click **Drafts**, **Open** or **Completed** to filter, and the eye to see where it stands. **Cancel Request** withdraws one you no longer need.

Managers ask HR to assign training to someone with the **Training Assignment Request** tile: pick the **Employee**, tick the trainings and add a due date if you like.

## Start a new hire

1. On **Requests**, click the **New Hire & Onboarding** tile.
2. Under **Employee information**, fill in the name, **Start date**, **Department**, **Labor role**, **Employment type**, **Location** and **Manager**. Pick **Preferred language** to send the packet in Spanish where a Spanish version exists.
3. Tick the **HR checklist** items, and the **Access** and **Software** they need under **Issued assets & access**.
4. Under **Training assignment**, tick the trainings. A due date is optional.
5. Check **Review & submit** and click **Submit Request**.
6. HR opens it from the board and clicks **Approve & Create Employee**. The employee record is made with their onboarding documents, trainings and access tasks. Click **Open employee record ›** to finish it.

## Work the request board

1. On **Requests**, click **Open board →**. The board shows HR's requests in columns: **Submitted**, **In Progress**, **Completed** and **Cancelled**.
2. Click a card to open the request. Change its status in the box at the top, or click **Approve** (**Approve & Create Employee** for a new hire). You can also drag a card to another column.
3. Click **Table** for a list you can search, sort and filter by status.
4. To move many at once, tick them, click **Actions** and pick **Move to Completed** (or another status). **Export selected to CSV** downloads them.

## Add and look up employees

1. Click **HR**, then **Employees**. Click a tile to show only those people, or pick a department and search by name or number.
2. To add someone who already works for you, click **Add Employee**. Type the **First name** and **Last name**; leave **Employee number** blank to get the next number. Fill in the **Start date**, **Status**, **Department**, **Labor role**, **Employment type**, **PTO group**, **Location** and **Reports to**, and click **Create Employee**.
3. Click a person to open their record. Click **Edit** on a card (**Name & number**, **Contact**, **Emergency contact** or **Job**), make the changes and click **Save Profile**. Click the photo square to add a photo.
4. When the details have been checked, click **Mark reviewed**.
5. Under **Portal access**, click **Create portal login**. Leave **Login email** blank for someone with no email: a login is made from their employee number. Give them the login and one-time password in person or by phone. To use a login they already have, type it under **…or link an existing login by email** and click **Link existing**.
6. Click **Export CSV** to download the roster.

The **Org chart** button draws the chart from each person's **Reports to**. Use **Fit**, **Collapse** and **Expand**, find a person or outline a department, switch to **Graph**, and check **Issues** for people with no supervisor. **CSV** downloads it.

## When someone leaves

1. Open the person and click **Assets & access**. Click **Returned** for each item handed back and **Revoke** for each account closed.
2. On **Profile**, click **Edit** on **Job**, pick **terminated** in **Status**, set the **Termination date** and click **Save Profile**.
3. Under **Portal access**, click **Unlink**.

To mark people inactive instead, tick them on **Employees**, click **Actions** and pick **Mark as Inactive** (**Mark as Active** brings them back). **Delete…** takes a record added by mistake off the lists; pick the **Deleted** stage to restore it.

## Send and collect onboarding documents

1. Open the person and click **Onboarding**.
2. Click **Assign whole packet**, or pick one under **Or assign one document** and click **Assign**.
3. The employee reads, acknowledges or signs each one in the **Employee Portal**.
4. For a form signed on paper, click **Upload signed copy**, pick the **Packet document**, the **Date signed** and the **Scanned file**, and click **Upload & attach**.

The **Stage** and **Outstanding** columns on **Employees** show who still owes documents. Click **Outstanding** to open that part of the record.

## Hand out company items and access

1. Click **HR**, then **Onboarding Tasks**. It opens on **Requested**, one row per item or account.
2. When the item is handed over or the account is set up, click the tick (**Provision**). If it can't be done, click the cross (**Deny**) and say why.
3. To record which phone or card someone has, open the person's **Assets & access** tab, click the pencil on the row, fill in its details and click **Save**.

## Assign trainings and print certificates

1. Open the person and click **Training**.
2. Pick the training under **Assign training**, add a **Due date** if you like, and click **Assign**.
3. For a class held in person, such as a tailgate safety meeting, click **Record completion** on its row, set the date and a note, and click **Save**.
4. For a completed training, click **View certificate**, then **Download PDF** or **Print**.

## Finish onboarding in the Employee Portal

Every employee does this part.

1. Click **HR**, then **Employee Portal**.
2. On **My Onboarding**, click **Open** on each document. To sign, click a **SIGN HERE** box, type your full legal name, draw your signature and click **Adopt & Sign**, then **Sign & Complete**. Other documents have **Acknowledge & Complete** or **Mark as Read**.
3. On **My Training**, click **Open**, tick **I have read and understand this training material.** and click **Complete Training**. Click **View / download** on a completed one for its certificate.
4. Check **My Profile** and **My Documents**.

## Request and approve time off

1. In the **Employee Portal**, click **My PTO** and read **Balance**, **Pending requests** and **Available**.
2. Under **Request PTO**, pick the **First day** and **Last day**, type the **Hours** and a **Note (optional)**, and click **Submit**. **Withdraw** takes back a pending request.
3. The manager clicks **Approvals** in the portal (it shows how many are waiting), then **Approve** (with a note if they like) or **Deny** with a reason.
4. To decide many, go to **Employees → PTO → Waiting on me**, tick them, click **Actions** and pick **Approve…** or **Deny…**.

## Keep PTO balances

1. On **Employees**, click **PTO**, then **Balances**. The **Below zero** and **Nothing entered** tiles show who needs attention.
2. To load opening balances, click **Import balances…** and pick a CSV or Excel file with **Employee #** and **Balance** columns. Check the preview and confirm.
3. For one person, open their **PTO** tab, pick the **Entry** type, type the **Hours**, **Effective** date and **Why**, and click **Add**.
4. To file time off for them, use **File PTO for this employee**, tick an HR exception if the waiting period or balance would stop it, and click **File**.
5. **All Requests** lists every request and its status; HR can cancel approved time off there.

## Post a job and review candidates

1. Click **Job Postings**, then **New job**. Fill in the **Job title**, **Department**, **Location**, **Type**, **Workplace**, **How people apply**, the pay (**From**, **To**, **Per**), **Summary**, **Qualifications**, **What you'll do** and **Requirements**, and tick the benefits.
2. Click **Save**, then **Publish to website**. Set **Close on** to take it down by itself, or click **Close posting** when it is filled.
3. Click **Candidates**. Click a candidate and **Open resume**. If AI screening is on, click **Score with AI** for a fit score, **Strengths**, **Gaps to check** and **Questions to ask**.
4. Under **Hiring stage**, pick the **Stage**, type **HR notes** and click **Save**. To move many, tick them and use **Actions**.
5. For a walk-in, click **Add candidate**, attach the resume and click **Add and score**.
6. To make an offer, click **Prepare offer letter**, check the details and click **Prepare**, then **Send**. The candidate gets a link to read and sign it with no account; it works once, for 14 days. For a letter signed on paper, use **Signed on paper** and **Save signed copy**.

## Record pay and raises

1. Open the person and click **Pay & benefits**.
2. In **Pay**, set **Effective**, pick **Hourly** or **Salary**, type the **Rate** and a **Reason**, and click **Record pay change**.
3. The history table lists each change and who recorded it. Only people with **See and change pay** see this.

## Run a pay period

When Payroll is turned on:

1. Click **Payroll**, then **New pay period**. Set **Period start**, **Period end** and **Check date**, and click **Create**.
2. Bring time in with **Import file**, **Fetch time**, or the **Time cards** tab: drop scanned paper time cards on **Drop time cards here**, check each card, click **Approve**, then **Post cards to this period**.
3. Click **Sync approved PTO**.
4. On **Review**, match any **Unmatched employees**, check the **Flags**, and click a cell to change hours. Every change needs a **Reason (required)**.
5. On **Export**, click **Export** and send the file to your payroll service. Click **Lock** once payroll has run.

## Reports and exports

1. Click **HR**, then **Reports**.
2. Under **Ready-made**, click **Employee roster** (or **Employee review**), check the **Report name** and click **Create report**.
3. Click **Print / Save as PDF**.

Employees, Onboarding Tasks, PTO, Candidates and Job Postings each have **Export CSV**, or tick rows and pick **Export selected to CSV** from **Actions**. To chart HR data, see [Dashboard](article:1d8a33a4-3a13-4874-b8e5-5ef9da22df95).

## Who can do what

Each action in the module needs a permission. A Workspace Admin gives permissions to roles; see [Users and roles: create and edit roles](article:88d4e232-d5b8-4909-b452-cfe96d3d550f). **Out of the box** shows the module's starting roles that have it.

| Permission | What it lets someone do | Out of the box |
|---|---|---|
| **Submit requests** | File HR requests and follow their own. | Admin, Operator, Viewer |
| **Request a new hire** | Submit New Hire & Onboarding requests. | Admin, Operator |
| **Submit general HR requests** | Submit General HR Requests. | Admin, Operator, Viewer |
| **Request training for someone** | Ask HR to assign training to someone with a Training Assignment Request. | Admin, Operator |
| **View all HR requests** | See every request in every department. **Give with care.** | Admin |
| **Work department request boards** | Move, assign and cancel requests on the boards of departments they are a member of. | Admin, Operator |
| **Approve HR requests** | Approve requests; approving a New Hire creates the employee. **Give with care.** | Admin |
| **View employee records** | See the employee list and records. **Give with care.** | Admin, Operator |
| **Edit employee records** | Add and edit employees, create and link portal logins, and assign documents. **Give with care.** | Admin |
| **View access checklists** | See which company items and system access each employee has been given. | Admin, Operator |
| **Grant and remove access** | Work Onboarding Tasks: mark items and access provided, denied, returned or revoked. | Admin, Operator |
| **Manage training** | Add and edit trainings, upload material and assign trainings. | Admin |
| **View their own HR profile** | See their own profile, trainings, documents and certificates in the Employee Portal. | Admin, Operator, Viewer |
| **Complete their own training** | Complete their own trainings and sign or acknowledge their onboarding documents. | Admin, Operator, Viewer |
| **Set up HR lists and departments** | Edit departments, labor roles, request types, checklists and who works each department's board. | Admin |
| **Manage onboarding documents** | Keep the onboarding document library and send packets to new hires. | Admin |
| **Request time off** | Request their own time off and see their balance. | Admin, Operator, Viewer |
| **Approve time off for their team** | Approve or deny time off for the people who report to them. | Admin, Operator |
| **Manage everyone's time off** | Keep everyone's PTO balances, enter accruals and corrections, import balances, and file time off for an employee with exceptions. **Give with care.** | Admin |
| **View the portal as an employee** | Open an employee's portal read-only to see what they see (every view is logged). **Give with care.** | Admin |
| **Manage job postings** | Post, edit and close jobs, and keep the benefits and requirements libraries. | Admin |
| **Review job candidates** | See applicants and their resumes, score them, prepare offer letters and move them through hiring stages. **Give with care.** | Admin |
| **Careers website: read jobs and take applications** | Only for the careers website's API key: read published jobs and send in applications. Never give it to a person or role. **Give with care.** | Nobody |
| **Run payroll** | Create pay periods, import and adjust time (with a reason), and export to payroll. **Give with care.** | Admin |
| **See and change pay** | See and record pay rates and raises. Everyone else never sees pay. **Give with care.** | Admin |
| **See the employee roster report** | Run the Employee roster report of current employees by department. | Admin, Operator |

- Managers come from the org chart. Anyone with people reporting to them can submit a New Hire request and sees **My Team**, whatever their role. With **Approve time off for their team**, they decide those people's time off.
- **Work department request boards** shows a board only to people added to it under **Request board access**, or who have **View all HR requests**.
- Saving HR's settings (PTO rules, certificate branding, careers website) is done by a Workspace Admin.

## Ask its agent

The **HR Assistant** answers from the module's help and from the HR records you may see. Try:

- "Who still owes onboarding documents or trainings?"
- "Headcount by department."
- "Assign the Employee Handbook training to Harper Cole, due next Friday."

It acts with your own permissions, shows you any change first and makes it only after you say yes. It can also add or update many employees from an attached spreadsheet, PDF or screenshot, after showing a preview. See [Agent chat](article:073c6465-d85c-4364-8768-acf42a3a6a48).

## Good to know

- Approving a New Hire request creates the employee. Keep **Approve HR requests** to the people who decide that.
- People without an email can still sign in: **Create portal login** makes a login from their employee number.
- Onboarding documents go out in Spanish where a Spanish version exists and the person's **Preferred language** is Español.
- **Score with AI** and reading paper time cards appear only when they are turned on, and use your workspace's own AI key. Resumes are then sent to the AI provider.
- Payroll is off until you turn it on. Its menu shows only to people who can run payroll.
- Pay rates are hidden from everyone without **See and change pay**, including in the HR Assistant and dashboards.

## More help

Open **Help** next to the title on any HR page for the full reference, and its **Runbooks** for step-by-step guides, such as *Set up HR for the first time*, *Start a new hire* and *Run a pay period*. See [Find and follow a runbook](article:4b62ad1f-577a-4998-8bce-f00226376522).


Source: https://datavisions.ai/docs/module-guides/hr
