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

# Visitor Approval

> Configure and manage the visitor approval workflow — require hosts to approve or reject walk-in visitors before granting access.

When visitors walk in without being pre-registered, you can require the host to approve the visit before granting access. This is especially useful for secure spaces or locations with a staffed front desk.

## Approval statuses

| Status                             | Meaning                                                                      |
| ---------------------------------- | ---------------------------------------------------------------------------- |
| **Not required**                   | No approval needed — visitor is expected and accepted (default)              |
| **Requested**                      | Approval has been requested from the host; waiting for response              |
| **Rejected**                       | Host has rejected the visitor                                                |
| **Accepted — hold for collection** | Host approved; visitor should wait at reception for the host to collect them |
| **Accepted — grant access**        | Host approved; visitor can be directed to the host's desk or unit            |

***

## Configuring visitor approval

Visitor approval settings are found under **Settings → Apps and integrations → Companion apps → NexIO**.

| Setting                                                    | Effect                                                                                                                   |
| ---------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| **Require host approval for walk-in visitors**             | Enables the approval flow. Walk-in visitors registered via NexIO receive a "Requested" status instead of "Not required". |
| **Automatically check approved visitors in**               | When enabled, an approved visitor is immediately checked in without staff intervention.                                  |
| **Host can choose to collect visitors at reception**       | Shows the "Accept — hold for collection" option in the approval email so the host can come to reception.                 |
| **Host can choose to send visitors to their unit or desk** | Shows the "Accept — grant access" option in the approval email so the visitor can proceed without escort.                |

<Info>
  You can disable either the "collect at reception" or the "grant access" response option to simplify the host's decision. If you disable both, only the reject option remains available.
</Info>

***

## When approval is triggered

Visitor approval is only triggered when **all** of the following are true:

1. The "Require host approval" setting is enabled for your location.
2. The visitor is registered via **NexIO** (walk-in self-registration at a kiosk or front-desk tablet).
3. A host (customer) is assigned to the visitor.

Visitors created **by staff in the Dashboard** or **by customers from the Members Portal** always receive a "Not required" status — they are considered pre-approved by nature of who registered them.

***

## How the approval flow works

<Steps>
  <Step title="Visitor self-registers at NexIO">
    The visitor enters their details and selects a host at the NexIO kiosk. The visitor's status is set to **Requested**.
  </Step>

  <Step title="Host receives an approval request">
    The system notifies the host through every channel you have enabled:

    * **Email** — always sent. The email contains action buttons to approve or reject.
    * **WhatsApp** — sent when the AI WhatsApp channel is enabled for the location and the host has a mobile number on their customer profile. See [Visitor approval on WhatsApp](visitor-approval-whatsapp).
    * **Mobile app push notification** — sent to hosts who have the Passport mobile app installed and signed in.

    The available actions depend on your settings:

    * **Accept — collect at reception**: Host will come to get the visitor.
    * **Accept — grant access**: Visitor can proceed to the host's desk.
    * **Reject**: Visitor is turned away.
  </Step>

  <Step title="Host responds">
    The host clicks one of the action links in the email, taps the Passport mobile app push notification, or replies to the WhatsApp message (with a number, a natural-language reply such as "approve Alex", or "approve all" for multiple visitors). The visitor's approval status is updated as soon as the host confirms the decision.
  </Step>

  <Step title="Staff and host are notified">
    Staff members subscribed to visitor notifications receive a system message indicating the visitor was accepted or rejected. If "Automatically check approved visitors in" is enabled and the host chose to grant access, the visitor is also checked in automatically.
  </Step>
</Steps>

***

## Visitor limits on plans

You can restrict how many visitors a customer can invite per day, week, or month by setting limits on their pricing plan. These limits are defined on each plan and enforced at the time a visitor is created:

| Plan setting           | Enforced when                                                          |
| ---------------------- | ---------------------------------------------------------------------- |
| **Visitors per day**   | Visitor's expected arrival falls on the same calendar day as the limit |
| **Visitors per week**  | Visitor's expected arrival falls in the same calendar week             |
| **Visitors per month** | Visitor's expected arrival falls in the same calendar month            |

If the customer exceeds the limit for their active plan(s), the visitor cannot be created and an error is displayed.

<Note>
  Visitor limits are cumulative across all active contracts — if a customer has two plans that both include visitor limits, the totals are summed.
</Note>

***

## Notification channels

### Email approval request

The system always sends an email to the host with action buttons to approve or reject the visitor. This email includes:

* The visitor's name, company, and reason for visit
* Expected arrival time
* Action buttons for each available response option

### WhatsApp approval

When the AI WhatsApp channel is enabled, hosts receive the approval request as a WhatsApp message and can reply with a number, in natural language, or process multiple visitors at once. See [Visitor approval on WhatsApp](visitor-approval-whatsapp) for full setup and configuration.

### Mobile app push notification

Hosts who have the Passport mobile app installed receive a push notification and can approve or reject directly from the app.

***

## Best practices

* **Enable approval for secure spaces** where you need explicit host permission before granting visitor access.
* **Use the "grant access" option** to reduce front-desk workload — approved visitors can proceed directly to the host's area.
* **Encourage hosts to use WhatsApp** for fastest response times, especially for mobile workers.
* **Set visitor limits on plans** to control how many guests members can invite and prevent abuse of the privilege.
* **Review pending approvals regularly** using the "Requested" status filter on the visitors list.

***

## Related pages

<CardGroup cols={2}>
  <Card title="Visitors" icon="user-plus" href="visitors">
    Main visitor management — registration, check-in, and lifecycle.
  </Card>

  <Card title="Visitor Approval on WhatsApp" icon="whatsapp" href="visitor-approval-whatsapp">
    Configure WhatsApp approval messages and let hosts respond conversationally.
  </Card>

  <Card title="NexIO" icon="tablet-screen" href="/platform/apps/nexio">
    Configure the walk-in visitor self-registration kiosk.
  </Card>

  <Card title="Members & Contacts" icon="users" href="members">
    Manage the customers who host visitors.
  </Card>
</CardGroup>
