> ## Documentation Index
> Fetch the complete documentation index at: https://help.gowindmill.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Onboarding

> See who is starting, who is still onboarding, and how quickly new hires ramp up compared with the people who came before them.

The Onboarding report shows who is joining your company and how new hires ramp up. Use it to prepare for upcoming start dates, spot new hires who don't have Windmill access yet, and see whether new hires reach the same activity levels as the people who onboarded before them.

Open it from the Analytics section of the [Windmill Dashboard](https://app.gowindmill.com/COMPANY/analytics) — select **Onboarding** from the list of reports.

![The Onboarding report showing the headline numbers, the onboarding period control, and the first 90 days timeline](https://mintcdn.com/windmill/lucliuUf9Og7mY4D/images/analytics/onboarding/overview.png?fit=max\&auto=format\&n=lucliuUf9Og7mY4D\&q=85\&s=0182dd67b028b3c3fee4f759b1e906a9)

## Who can view this report

Like [Organizational Health](https://help.gowindmill.com/features/analytics/organizational-health.md), Onboarding is only available to people who can see Analytics for the entire organization: **Workspace Admins** and **Data Analysts**.

> [!NOTE]
>
> HR Admins, managers, and other members don't see the Onboarding report, even if they can open other Analytics reports.

Group filters and the **Group** comparison only include groups you have permission to see.

## Choosing who and what to measure

The control panel at the top of the report sets the scope for every section.

### Employee filter

Search by name or email, or filter by group, job title, manager, start date, or tenure. Leave the filter empty to include all employees. The line below the filter shows how many employees are in scope.

The report counts every employee in your org chart, not only people who have a Windmill account.

### Onboarding period

The onboarding period sets how long someone counts as a new hire. It replaces the date range used in other Analytics reports.

* **Length** — 30, 60, 90, or 180 days. The default is 90 days.
* **Calendar days** or **Business days** — Business days count Monday through Friday only. If someone starts on a weekend, their business days start the following Monday.

A person's start date is day 1. Their onboarding period ends when they've completed the selected number of days.

Your filter and onboarding period are saved in the URL, so you can bookmark or share a specific view.

## Headline numbers

Five numbers summarize hiring for the current filter. Hover over a number, then hover over the info icon next to its name to see how it's counted.

| Number | What it counts |
| - | - |
| **Headcount** | Employees who have started, plus current employees without a start date. People with a future start date aren't counted yet. |
| **In their first \[period]** | Current employees who started within the onboarding period. |
| **Starting in the next 30 days** | Employees with a start date in the next 30 days. |
| **Starting without Windmill access** | Employees starting in the next 30 days who aren't active Windmill members yet. |
| **Missing a start date** | Current employees without a start date. Apart from **Headcount**, the report leaves them out. |

Select a number to see the people behind it, with their job title and manager.

> [!TIP]
>
> Check **Starting without Windmill access** before a start date so you can invite new hires and Windy can welcome them from day 1.

## Onboarding timeline

The **First \[period] timeline** lists everyone currently onboarding and everyone with a future start date, grouped by the week they start.

![The onboarding timeline with people grouped by start week and progress bars that run to the end of each person's onboarding period](https://mintcdn.com/windmill/lucliuUf9Og7mY4D/images/analytics/onboarding/timeline.png?fit=max\&auto=format\&n=lucliuUf9Og7mY4D\&q=85\&s=b1ac7c763975affa4e7dbcdec7581c6a)

Each person has a bar that runs from their start date to the end of their onboarding period:

* **So far** — The part of the onboarding period that has passed.
* **Still ahead** — The part that hasn't happened yet.
* **Not started yet** — A dashed bar for people with a future start date.
* **Every 30 days** — Tick marks at each 30-day milestone.

A **Today** marker shows where today falls. Each week shows how many people started and which day of onboarding they're on.

People without full Windmill access have a badge next to their name:

* **Not signed in** — They have a Windmill seat but haven't signed in yet.
* **No access** — They don't have an active Windmill seat.

Select a name to open that person's profile. Use **Expand all** or **Collapse all** to show or hide everyone in each week. Weeks start collapsed when more than 30 people are listed.

## New hires by week

The **New hires by week** chart shows current employees by the week they start, from one year ago through the latest future start date. Each bar is split into:

* **Past their first \[period]**
* **In their first \[period]**
* **Not started yet**

Select a section of a bar to see who started that week.

![The New hires by week chart with bars split into past their first 90 days, in their first 90 days, and not started yet](https://mintcdn.com/windmill/lucliuUf9Og7mY4D/images/analytics/onboarding/hires-by-week.png?fit=max\&auto=format\&n=lucliuUf9Og7mY4D\&q=85\&s=7797478df65e3f4cab31a8452b01dceb)

## Ramp-up

The **Ramp-up** chart compares how quickly new hires reach typical activity levels for a stat you choose, such as Slack messages sent. Use it to see whether new hires are ramping up on pace and which ones might need more support.

![The Ramp-up chart showing the benchmark median and middle 50% band, the new hires median, and individual new hires](https://mintcdn.com/windmill/lucliuUf9Og7mY4D/images/analytics/onboarding/ramp-up.png?fit=max\&auto=format\&n=lucliuUf9Og7mY4D\&q=85\&s=2ad72de228066a1c76cb9f07d4a81650)

### How ramp-up is measured

Everyone is measured from their own start date, so a person who started in March and a person who started in June are compared at the same point in their onboarding.

The chart compares two groups of people in your filter:

* **Benchmark** — People who started on or after the date Windmill began recording the stat, and who have finished their onboarding period. The chart shows the benchmark's median as a gray line, and the range covered by the middle 50% of the benchmark as a gray band.
* **New hires** — People who have started but haven't finished their onboarding period yet. The chart shows the new hires' median as a blue line.

The line above the chart lists how many people are in each group and the date the stat's data starts.

### Choosing a stat and time scale

Select the stat button to choose a different stat. Stats are grouped by integration. Stats from integrations you haven't connected aren't available. The report starts with **Slack Messages** when it's available.

The chart is divided into periods:

* **Calendar days** — Choose **Weeks** or **Months**. Months need an onboarding period of at least 60 days.
* **Business days** — The chart shows each business day for a 30-day period, and five-day blocks (**Days 1-5**, **Days 6-10**, and so on) for longer periods. Activity on a weekend counts toward the next business day.

A period only appears on the chart once it's complete. If an integration hasn't synced recent data, the latest periods stay empty instead of showing zero.

### Comparing individual new hires

The table below the chart lists everyone in their onboarding period, newest first.

| Column | What it shows |
| - | - |
| **New hire** | The person's name. Select it to open their profile. |
| **Started** | Their start date and which day of onboarding they're on. |
| **So far** | Their total from their start date through their last complete period. |
| **Benchmark by then** | The benchmark median over the same number of periods. |
| **Difference** | How far above or below the benchmark they are. Shown only when the benchmark is above zero. |

Select up to five people to add them to the chart as dashed lines.

### Comparing groups

Use **Compare** to split the ramp-up chart by:

* **Start quarter** — For example, Q3 2026 hires compared with Q2 2026 hires.
* **Job title**
* **Group** — Any group in Windmill that you can see.

Choose up to six values. Each value gets its own median line, and the benchmark stays on the chart for reference. Each group line includes everyone in that group who has reached that period, including people who have finished onboarding. The new hires table is hidden while you compare groups.

![The Ramp-up chart comparing median lines for several start quarters against the benchmark](https://mintcdn.com/windmill/lucliuUf9Og7mY4D/images/analytics/onboarding/compare.png?fit=max\&auto=format\&n=lucliuUf9Og7mY4D\&q=85\&s=b47247b75f7a5e5f682443eee7109298)

### Messages you might see

* **No benchmark yet** — No one in your filter has started and finished their onboarding period since the stat's data started. Try a shorter onboarding period or a stat with a longer history.
* **Narrow the filter to compare similar roles** — At least a quarter of the people in the benchmark had none of this stat during onboarding, which pulls the benchmark down. For example, Engineering activity stats don't reflect how Sales hires ramp up. Filter by job title or group so you compare people whose work the stat measures.
* **No data for some groups yet** — Some of the groups you're comparing don't have data for this stat, so they aren't on the chart.
* **There are too many employees to compare at once** — Narrow the employee filter and try again.

## What the report needs

* **Start dates** — Every section uses each employee's start date. Sync start dates from your HRIS (Human Resources Information System) or [update them on employee profiles](https://help.gowindmill.com/org-chart/employee-information.md). Employees without a start date are counted under **Missing a start date** and left out of the rest of the report.
* **Integrations** — Ramp-up uses activity from the integrations you've connected. See the [full stats reference](https://help.gowindmill.com/data/stats.md) for what each integration records.

## FAQs

> **Why isn't a new hire showing up in the report?**
>
> Check that they have a start date and match the employee filter. The timeline only includes people who are within their onboarding period or who start in the future, and the ramp-up table only includes people who have started and are still onboarding. The New hires by week chart covers start dates from one year ago through the latest future start date.

> **Why is the ramp-up benchmark so low?**
>
> The benchmark includes everyone in your filter who finished onboarding. If many of them don't use the tool that the stat measures, the median drops. Filter by job title or group so the benchmark only includes people in similar roles.

> **Why don't I see a benchmark at all?**
>
> The benchmark only includes people who started on or after the date Windmill began recording the stat, and who have finished their onboarding period. If you connected the integration recently, no one may have finished onboarding since then. Try a shorter onboarding period.

> **Why are the most recent periods empty?**
>
> A period only appears once it's complete and the integration has synced data for it. See [Data Sync and Freshness](https://help.gowindmill.com/data/data-sync-and-freshness.md) for sync schedules.

> **Do former employees count?**
>
> Former employees aren't included in the headline numbers, timeline, or new hires by week. They can be part of the ramp-up benchmark and group comparisons, so the benchmark reflects everyone who onboarded during that time.

> **Can I export the Onboarding report?**
>
> The Onboarding report doesn't have an export. Use [Explore](https://help.gowindmill.com/features/analytics/explore.md) to export stats for specific people and dates.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.