> ## 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.

# Deduction Types

> Admin catalog for managing payroll deduction type definitions used across the organization.

The Deduction Types page manages the organization's catalog of payroll deduction type definitions. It is available at route `/hr/payroll/deduction-types`.

## Overview

The page lists deduction types fetched by `useDeductionTypes`, filterable by search text and category. An "Include Inactive" toggle controls whether deactivated types are shown. Each row shows the type name, category badge, and formatted values (amount or percentage, cap). Users with `hr.deduction_types.manage` can add new types via the **+** button (opens `DeductionTypeFormDialog`), edit existing types, and deactivate types (via `useDeactivateDeductionType`). Actions are surfaced in a dropdown menu per row.

## Who it's for

Viewing: No explicit `RequirePermission` wrapper on the route. Manage actions (add, edit, deactivate) are gated by `hr.deduction_types.manage` at the component level via `useHasPermission`.

## Before you start

* Deduction type definitions must exist before they can be assigned to employees.
* Consult your payroll administrator before creating or editing deduction types.

## Steps

<Steps>
  <Step title="Open Deduction Types">
    Navigate to **HR → Payroll → Deduction Types** or go to `/hr/payroll/deduction-types`.
  </Step>

  <Step title="Search and filter">
    Use the search box to find a type by name. Use the Category filter to narrow by pre\_tax, post\_tax, garnishment, or voluntary. Toggle "Include Inactive" to show deactivated types.
  </Step>

  <Step title="Add a deduction type (if permitted)">
    Click **+** to open the form dialog. Enter name, category, and other fields.
  </Step>

  <Step title="Edit or deactivate (if permitted)">
    Use the row dropdown menu to edit a type or deactivate it.
  </Step>
</Steps>

## Key concepts

* **Categories** — `pre_tax`, `post_tax`, `garnishment`, `voluntary`. The category badge variant varies per category (default, secondary, destructive, outline).
* **Inactive types** — Deactivated types are hidden by default but can be shown with the "Include Inactive" toggle.

## 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/DeductionTypesListPage.tsx
  * src/cores/hr/hooks/payroll/useDeductionTypes.ts
</Accordion>