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

# Offer Letter Wizard

> Use the guided Offer Letter Wizard to draft, review, and send application-scoped or direct employment offers from the HR applicant tracking system.

The Offer Letter Wizard is a multi-step guided flow for creating offer letters. It supports both application-scoped and direct-offer entry points:

* Application mode: `/hr/ats/applications/:id/offer`
* Direct mode: `/hr/ats/offers/new`

## Overview

The Offer Letter Wizard (`OfferLetterWizardPage`, HR-UX-14) launches the `OfferLetterWizard` in one of two modes:

* **Application mode** pre-fills recipient context from an existing application.
* **Direct mode** lets you select a recipient directly (candidate or employee) and optionally create a candidate inline.

In both modes, the wizard walks you through drafting the offer, reviewing terms, and routing the result into the standard offer record. On completion you are redirected to the offer detail page.

The `FEATURE_HR_JOB_OFFER_WIZARDS` platform flag controls access to the wizard. As of June 12, 2026, the flag ships **enabled globally**, so the wizard is reachable in every organization without further setup. If a platform admin turns the flag off, the page shows a notice and a return action (**Back to Application** or **Back to Offers**) instead of the wizard.

## Who it's for

Recruiters and HR administrators who manage candidate and employee offers. Both wizard routes require the `hr.ats.offers.create` permission; users without it get a 403 from the route guard.

## Before you start

* You must have the `hr.ats.offers.create` permission.
* For application mode, open an application from `/hr/ats/applications` and use **Make Offer**.
* For direct mode, open `/hr/ats/offers/new` from the offers list.
* The `FEATURE_HR_JOB_OFFER_WIZARDS` platform flag must be enabled for your environment. It ships enabled by default as of June 12, 2026, so no setup is needed unless a platform admin has explicitly turned it off. See [Feature flags integration](/architecture/integrations/feature-flags-integration) for how flags are evaluated.
* Confirm job posting and compensation details are available.

## Steps

1. Start from either `/hr/ats/applications/:id/offer` (application mode) or `/hr/ats/offers/new` (direct mode).
2. In **Select Recipient**, confirm the application candidate or select a direct candidate or employee.
3. Complete each wizard step, providing compensation, terms, and approval routing.
4. Submit the wizard. A new offer record is created and you are redirected to `/hr/ats/offers/:offerId`.
5. To exit without finishing, use the exit action to return to the launching page.

## Feature flag behavior

When `FEATURE_HR_JOB_OFFER_WIZARDS` is **disabled**, wizard routes show:

* A heading reading **Create Offer Letter**.
* A message explaining that the guided wizard is disabled for the current environment.
* A route-aware return button (**Back to Application** or **Back to Offers**).

In this state, create offers using the standard actions on the application detail page or the offers list.

### Checking the flag in code

```tsx theme={null}
import { useFeatureFlag } from '@/platform/feature-flags';

function OfferEntryPoint() {
  const { enabled } = useFeatureFlag('FEATURE_HR_JOB_OFFER_WIZARDS');

  if (!enabled) {
    return <LegacyOfferActions />;
  }

  return <OfferLetterWizardLink />;
}
```

## Key concepts

* **Dual entry modes** — Wizard supports application-scoped creation and direct creation without an application.
* **Permission gate** — Both wizard routes require `hr.ats.offers.create`. Without it the route guard blocks access.
* **Feature flag gate** — `FEATURE_HR_JOB_OFFER_WIZARDS` controls whether the guided experience is shown. Fails safe to disabled if evaluation errors.
* **Completion handoff** — On submit, the wizard hands off to the offer detail page (`/hr/ats/offers/:offerId`) for approval, signature, background, and negotiation tracking.

## Related

<Columns cols={2}>
  <Card title="Offer Details" icon="file-signature" href="/hr/offers">
    Review and manage a single offer record after the wizard completes.
  </Card>

  <Card title="Applications" icon="folder-open" href="/hr/applications">
    Browse and open candidate applications.
  </Card>

  <Card title="Feature Flags" icon="layer-group" href="../architecture/integrations/feature-flags-integration.md">
    How flags are evaluated and configured.
  </Card>

  <Card title="Human Resources" icon="users" href="/hr/overview">
    Human Resources core overview.
  </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/ats/OfferLetterWizardPage.tsx
  * src/cores/hr/wizards/offer-letter
  * src/platform/feature-flags/useFeatureFlag
  * src/platform/navigation/route-labels.ts
</Accordion>