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

# Availability

> Set weekly availability preferences and shift preferences to guide shift scheduling assignments.

Availability Settings is at primary route `/hr/scheduling/availability`. The alternate route `/hr/availability` maps to the same screen. Both require `HR_PERMISSIONS.SCHEDULING_ADMIN`.

## Overview

The Availability Settings page (`AvailabilitySettings`) allows configuration of weekly availability preferences to guide shift scheduling. An informational card explains the three-part workflow: setting per-day availability, specifying shift preferences (regular, on-call, overtime), and adding notes with additional context. The page renders the `AvailabilityPreferencesForm` component for data entry. The in-app note states that preferences are guidelines and may be adjusted based on business needs.

Alternate route `/hr/availability` also resolves to this screen.

## Who it's for

`HR_PERMISSIONS.SCHEDULING_ADMIN` — scheduling administrators.

## Before you start

* Scheduling admin permission required.

## Steps

<Steps>
  <Step title="Open Availability Settings">Navigate to `/hr/scheduling/availability` or `/hr/availability`.</Step>
  <Step title="Set day-of-week availability">Use `AvailabilityPreferencesForm` to mark availability for each day of the week.</Step>
  <Step title="Specify shift preferences">Select regular shifts, on-call, or overtime willingness per day.</Step>
  <Step title="Add notes">Enter any additional restrictions or considerations in the notes field and save.</Step>
</Steps>

## Key concepts

| Term                              | Meaning in code                                            |
| --------------------------------- | ---------------------------------------------------------- |
| `AvailabilityPreferencesForm`     | Form component for entering per-day scheduling preferences |
| `HR_PERMISSIONS.SCHEDULING_ADMIN` | Permission constant required to access this route          |

## 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">
    Documentation coverage and governance.
  </Card>
</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/AvailabilitySettings.tsx
</Accordion>