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

# Tax Tables

> View and edit FICA configuration and federal tax withholding brackets by tax year, filing status, and pay frequency for payroll tax calculation reference.

The Tax Tables page displays FICA configuration values and federal tax withholding brackets, with editing capabilities for FICA rates gated behind `PermissionGate`. It is served at route `/hr/payroll/tax-tables`.

## Overview

The page uses `useFicaConfigList`, `useFederalTaxBrackets`, and `useTaxYears` to load data for a selected tax year. Filter controls allow selecting filing status (single, married jointly, head of household) and pay frequency (weekly, bi-weekly, semi-monthly, monthly). FICA configuration is displayed in cards with an edit dialog; the edit action is wrapped in a `PermissionGate`. Federal tax brackets are displayed in a `DataTable`.

This page is part of the HR-PAY-01 Tax Table Administration feature.

## Who it's for

No explicit `RequirePermission` guard on this route. Edit actions are gated by `PermissionGate`. SME: confirm required permission.

## Before you start

* Tax year data must be seeded or imported before this page displays meaningful values.

## Steps

**View tax tables**

1. Navigate to **HR > Payroll > Tax Tables** or go to `/hr/payroll/tax-tables`.
2. Select the **Tax Year** from the dropdown.
3. Select **Filing Status** and **Pay Frequency** to filter federal brackets.
4. Review FICA configuration values in the summary cards.
5. Browse federal tax brackets in the data table.

**Edit FICA configuration** (requires appropriate permission via `PermissionGate`)

1. Click the edit icon on a FICA configuration card.
2. Modify rate or threshold values in the dialog.
3. Save changes.

## Key concepts

| Term                 | Meaning                                                                                                                                                                             |
| -------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| FICA                 | Federal Insurance Contributions Act. Values include Social Security and Medicare rates and thresholds. SME: confirm current values — not documented here to avoid regulatory error. |
| Federal tax brackets | Withholding tables used for payroll tax calculation, filtered by filing status and pay frequency. SME: confirm source and update process.                                           |
| Filing status        | Employee's tax filing designation: single, married jointly, or head of household.                                                                                                   |

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