Skip to main content
The Create Payroll Run page launches a wizard to create a new payroll run or edit an existing draft. It is available at route /hr/payroll/runs/new. The edit path /hr/payroll/runs/:runId/edit uses the same component in edit mode.

​
Overview

The page renders PayrollWizardRouter with an optional draftId (present when editing an existing run via :runId). The page title is “Edit Payroll Run” when a runId param is present, and “Create Payroll Run” otherwise. On wizard completion, the user is redirected to the payroll run detail page at /hr/payroll/runs/:payrollRunId. Cancel returns to /hr/payroll/runs. The legacy redirect route /hr/payroll/adjustments navigates to /hr/payroll/runs/new.

​
Who it’s for

Access follows your organization’s role and module configuration. Any authenticated user who can reach /hr/payroll/runs/new will see the page.

​
Before you start

  • Confirm the payroll period dates and employee scope before starting the wizard.
  • For edit mode, the run must exist in draft status; navigate to /hr/payroll/runs to find and select the draft.

​
Steps

1

Open the Create wizard

From HR → Payroll → Runs, click the action to create a new run. You land on /hr/payroll/runs/new.
2

Complete wizard steps

Follow the prompts in the PayrollWizardRouter. Step content is defined in the wizard component.
3

Submit

Completing the final wizard step creates the payroll run and redirects to its detail page.
4

Edit a draft run

To resume an existing draft, navigate to /hr/payroll/runs/:runId/edit. The wizard loads with pre-filled values from the draft.

Human Resources

Human Resources core overview.

Governance & parity

This page documents shipped product behavior. It is not medical, legal, or billing advice. Verify against your organization’s policies and applicable regulations before using it for clinical, compliance, or billing decisions. Protected health information (PHI) shown in the product is governed by your tenant’s access controls and is never exposed in this documentation.
  • src/routes/hr.tsx
  • src/cores/hr/pages/CreatePayrollRunPage.tsx
  • src/cores/hr/components/payroll/PayrollWizardRouter.tsx