Offer Letter Wizard

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

​

Overview

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

​

Who it’s for

​

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

• 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).

​

Checking the flag in code

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