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

# HR Settings

> Configure organization-wide HR module defaults, integrations, job description settings, fingerprint clearance settings, and geofence configuration.

The HR Settings page (`/hr/settings`) provides organization-wide configuration for the HR module, organized into General and Integrations tabs.

## Overview

The page is organized into two tabs:

**General tab** includes:

* **Module Configuration** — `HRSettingsForm` with organization-wide HR defaults, applying to all users in the current organization. Includes **Pathway templates enabled** (`pathway_templates_enabled`), which exposes AHCCCS qualification [pathway templates](/hr/pathway-templates) on position detail pages.
* **Platform Module Presets** — a link to `/settings/modules` to enable/disable HR sub-modules.
* **Job Description Settings** — `JobDescriptionSettingsSection`.
* **Fingerprint Clearance Settings** — `FingerprintClearanceSettingsSection`.
* **Geofence Configuration** — `GeofenceConfigList`.

**Integrations tab** includes:

* **Data Import & Migration** — card with link to `/hr/setup/import` (gated by `hr.employees.create`).
* **Checkr Settings** — `CheckrSettingsSection`.
* **Background Check Providers** — `BackgroundCheckProvidersSection`.
* **Webhook DLQ** — `WebhookDLQSection`.
* **Job Board Integrations** — `JobBoardIntegrationsSection`.

A guided tour is available via the **Help** button (`hrSettingsTour`). Unsaved changes are tracked and a dirty state warning is shown.

## Who it's for

Requires permission: `hr.settings.admin` (`HR_PERMISSIONS.SETTINGS_ADMIN`).

## Before you start

* You need the `hr.settings.admin` permission.
* Changes to General settings apply to all users in the organization immediately on save.

## Steps

1. Navigate to **HR → Settings** or go to `/hr/settings`.
2. On the **General** tab, update module configuration defaults and click save.
3. Click **Configure Modules** to enable or disable HR sub-modules.
4. On the **Integrations** tab, configure background check providers, job board connections, or open Data Import.
5. Click the **Help** button to start the guided tour.

## 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/HRSettingsPage.tsx
  * src/cores/hr/hooks/settings/useHRModuleSettings.ts
</Accordion>