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

# Host Dashboard

> Dashboard for housing hosts to view their assigned guests and accommodations

# Host Dashboard

The Host Dashboard gives housing hosts a dedicated view of their assigned guests, including guest details, arrival status, and stay dates.

## Overview

The Host Dashboard shows hosts:

* **Assigned Guests** - All guests staying at their location
* **Guest Details** - Names, contact info, and special needs
* **Arrival Status** - Whether guests have been marked arrived at the host location
* **Stay Dates** - Arrival and departure dates

<Info>
  **Arrival status** is housing-specific — hosts mark when a guest **arrives at their home**, not general event QR check-in.
</Info>

## Accessing the Host Dashboard

### Web (hosts)

Organizers email hosts a link to the **public host dashboard**:

```
/public-host-dashboard/?org={org_id}&event={event_id}&location={location_id}&host_token={token}
```

The `host_token` is required for **Mark Arrived** actions. Links are minted when organizers send host dashboard emails from the event housing section.

<Warning>
  `/host-dashboard/?org=…&event=…&location=…` is the **logged-in admin/internal** view. It does not include **Mark Arrived** — that action lives on the public host dashboard with a valid `host_token`.
</Warning>

### Web (from My Event)

When a logged-in user is the host for a housing location, **My Event** can mint a token and redirect to `/public-host-dashboard/` with `host_token`.

### Mobile App

Hosts open the Host Dashboard from **My Event** when they are assigned as a housing host for **their own** registrant tab.

## Dashboard Features

### Summary Statistics

* **Total Guests** — Assigned to this location
* **Checked In** — Guests marked **arrived** at the host location
* **Capacity** / **Current Occupancy** — Location limits and usage

Guest cards show **Pending Check-in** or **✓ Checked In** (not a separate "Expected" summary stat).

### Guest Cards

Each guest displays:

* **Name**
* **Arrival status** - Marked arrived or expected
* **Stay Dates** - Arrival and departure
* **Contact Info** - Phone or email
* **Dietary Restrictions** and **Special Needs**
* **Notes**

### Mark Arrived

**Web (public host dashboard):** Tap **Mark Arrived** next to each guest (requires `host_token` in the URL).

**Mobile:** Tap **Mark Arrived** on each guest card in the Host Dashboard screen.

## Notifying Guests (Mobile)

Hosts can send **push notifications** to all guests assigned to their home:

1. Open the Host Dashboard (mobile)
2. Tap **Send Notification**
3. Type your message (title is set automatically as "Message from your host")
4. Send

Guests receive a push notification on the ChurchBuddy mobile app if they have notifications enabled.

<Info>
  Push messaging to guests is a **mobile app** feature. Web public host dashboard supports viewing guests and **Mark Arrived**.
</Info>

## For Event Organizers

1. Assign guests to housing locations with a host email
2. Click **Email Dashboard to Host** in the housing section to send the public link with `host_token`
3. Share arrival instructions before the event

## Best Practices

1. **Send the public link** — not the internal `/host-dashboard/` URL
2. **Include all URL parameters** — org, event, location, and host\_token
3. **Review guest details** — Check dietary restrictions before guests arrive
4. **Use mobile push for updates** — Send arrival instructions or schedule changes

See also [Housing Management](/ChurchBuddy/Events/housing).