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

# AI Headshots

> Generate AI professional headshots by uploading photos, selecting a style, and setting the result as a profile photo.

The AI Headshots screen enables staff to generate professional headshots using AI at the route `/headshots`.

## Overview

Users can generate professional headshots by uploading source photos through an upload wizard, selecting a headshot style, and submitting the job to the `pf-headshot-submit` Edge Function. A status banner displays active or processing jobs. Generated results appear in a gallery that supports lightbox viewing, favoriting, downloading, and setting the result as the user's profile photo. A consent dialog must be accepted before the first generation.

## Who it's for

Required permission: `platform.headshots.generate`

## Before you start

* You must hold the `platform.headshots.generate` permission.
* Accept the consent dialog before generating headshots for the first time.

## Steps

<Steps>
  <Step title="Open AI Headshots">Navigate to `/headshots`.</Step>
  <Step title="Accept consent">On first use, review and accept the consent dialog to enable AI headshot generation.</Step>
  <Step title="Click Generate Headshots">Click the "Generate Headshots" button to open the upload wizard.</Step>
  <Step title="Upload photos and select style">Upload one or more source photos and choose a headshot style, then submit.</Step>
  <Step title="Wait for processing">Monitor the status banner; generation may take a few minutes.</Step>
  <Step title="Review and use results">Browse the gallery, favorite preferred results, download images, or set one as your profile photo.</Step>
</Steps>

## Key concepts

* `HeadshotStyle` — style variant chosen during the upload wizard
* `pf-headshot-submit` — Edge Function that processes the generation job
* Favoriting — mark preferred results for easy retrieval
* Set as profile photo — applies the selected headshot to the user's `pf_profiles` record

## Related

<Columns cols={2}>
  <Card title="Platform Foundation" icon="layer-group" href="/pf/overview">
    Platform Foundation 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/platform.tsx
  * src/platform/headshot/pages/HeadshotPage.tsx
</Accordion>