> ## Documentation Index
> Fetch the complete documentation index at: https://docs.sitesuper.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Managing supers

> Create superintendents, set their contact channels and fallback rules, assign them to projects, and test every channel.

A **super** (superintendent) is the field worker who gives the daily report. They never log in — SiteSuper reaches out to them. This page covers everything about setting them up well.

## Create a super

1. In the sidebar, click **Supers → Add Super**.
2. Fill in the profile and contact preferences (below).
3. Save — you land on the super's detail page.

## Profile fields

<ParamField path="Full name" type="required">
  The super's name, e.g. `John Smith`. Used in the call/message script.
</ParamField>

<ParamField path="Phone" type="required for calls/SMS">
  The number SiteSuper calls. Choose the country (defaults to 🇨🇦 Canada) and enter the number — it's stored in international **E.164** format (`+16045550100`) and validated inline. An invalid number blocks the save.
</ParamField>

<ParamField path="Email" type="optional">
  Enables email-based report requests and lets the super reply by email to file a report.
</ParamField>

<ParamField path="Text Message Number" type="optional">
  Only needed if the super's SMS number is different from their voice line (common with dual-SIM phones). If left blank, SMS uses the voice number.
</ParamField>

<ParamField path="WhatsApp" type="optional">
  The super's WhatsApp number, if you'll use that channel.
</ParamField>

## Contact preferences

These decide how SiteSuper reaches the super at the scheduled time.

<ParamField path="Primary method">
  `phone`, `sms`, `whatsapp`, or `email` — the first channel tried.
</ParamField>

<ParamField path="Fallbacks">
  Up to two ordered backup channels, used if the primary doesn't produce a report within the callback window.
</ParamField>

<ParamField path="Callback timeout">
  How long to wait (default **15 minutes**) before moving to a fallback. On a phone call, if SiteSuper hits voicemail it sends an SMS asking the super to call back, then retries before falling back.
</ParamField>

<Tip>
  Per-schedule overrides let you use different channels at different times — see [Schedules](/schedules). The global preferences here are the default.
</Tip>

## Test every channel

Before relying on a schedule, verify each channel works.

1. On the super's **Profile** tab, each contact field shows a **Send test** link when a value is present.
2. Click it — SiteSuper sends a real test through that exact channel (a test call, or a short test message).
3. You'll see **Sent ✓** on success, or the specific error if something is misconfigured.

<Warning>
  WhatsApp outbound uses a pre-approved Meta template — free-form WhatsApp messages are blocked by Meta until the recipient replies first. The test sends that template, so it mirrors a real scheduled WhatsApp dispatch.
</Warning>

<Note>
  **WhatsApp is two-way.** Once a super replies, the AI agent holds a natural back-and-forth to collect the report — the super can send photos (captured automatically), ask what today's goals or [working hours](/schedules#working-hours) are, and even [add or correct a contact](/contacts#let-the-ai-keep-contacts-current), all in the same chat.
</Note>

## Assign to projects

Supers are organization-wide and **assigned** to the projects they work on.

<Tabs>
  <Tab title="From the super's page">
    Open the super's **Projects** tab → **Add to project…** → pick a project. The super is assigned and gets a dedicated **ingest email** for that project (any email they send there becomes a report).
  </Tab>

  <Tab title="From the project">
    Open the project's **Team** page → **Site Supers** → **Add super to project…**. Same result — no invite needed.
  </Tab>
</Tabs>

The workspace **Supers** list shows a **Projects** column with a badge per assignment.

## The public report link

Every super has a unique public **report link** (`/report/<token>`), shown on their detail page. They can open it in any browser and submit a report directly — a universal fallback that needs no app and no login.

## Suspend or delete

* **Suspend** — set the super's status to **inactive** to halt all dispatch while keeping their history. Reactivate any time.
* **Delete** — permanently removes the super and their schedules and reports. Prefer suspend unless you're sure.