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

# Create Payroll Run

> Wizard to create or edit a draft payroll processing run.

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

<Steps>
  <Step title="Open the Create wizard">
    From **HR → Payroll → Runs**, click the action to create a new run. You land on `/hr/payroll/runs/new`.
  </Step>

  <Step title="Complete wizard steps">
    Follow the prompts in the `PayrollWizardRouter`. Step content is defined in the wizard component.
  </Step>

  <Step title="Submit">
    Completing the final wizard step creates the payroll run and redirects to its detail page.
  </Step>

  <Step title="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.
  </Step>
</Steps>

## Related

<Columns cols={2}>
  <Card title="Human Resources" icon="users" href="/hr/overview">
    Human Resources core overview.
  </Card>

  <Card title="Governance & parity" icon="scale-balanced" href="/governance/index" />
</Columns>

<Note>
  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.
</Note>

<Accordion title="Documentation sources">
  * src/routes/hr.tsx
  * src/cores/hr/pages/CreatePayrollRunPage.tsx
  * src/cores/hr/components/payroll/PayrollWizardRouter.tsx
</Accordion>