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

# Housing Management

> Manage housing locations and assign guests to hosts for your events

# Housing Management

ChurchBuddy's housing system helps you coordinate accommodations for events: create locations, assign guests to hosts, track occupancy, and share host dashboards.

## Overview

* **Housing locations** — Houses, rooms, dormitories
* **Drag-and-drop assignments** — Assign registrants to locations
* **Bulk Assign** — Assign many registrants at once via modal
* **Host dashboard** — Public link with `host_token` for hosts
* **Export** — CSV export of housing data

## Setting Up Housing

1. Open **Event Dashboard → Logistics**
2. Enable **Housing** under **Enable Services** (Owner/Org Admin)
3. Click the **Housing** sub-section

## Housing Locations

### Creating a Location

1. Click **Add Location**

2. Fill in details:

   **Basic:** Name, location type (house/room/dormitory), optional room type, address, phone

   **Capacity:** Capacity, optional overbook limit

   **Host:** Host name, email, phone; **Share Guest Info with Host** checkbox

   **Details:** Amenities, gender restriction, accessible flag, check-in/out dates, cost per night, notes

3. Save

<Info>
  There is no **Host Requires Account** or **Host Account Email** field in the location modal — hosts use the public dashboard link with `host_token`.
</Info>

### Editing / Deleting

Use the edit or delete controls on each location card. Deleting a location does not automatically remove existing assignments — reassign guests first if needed.

### Occupancy

**Current occupancy** updates automatically when assignments change.

## Assigning Guests

The Housing UI uses **drag-and-drop**:

1. Open **Logistics → Housing**
2. Registrants appear in an unassigned list
3. **Drag registrants onto a location** to assign them
4. Or click **Bulk Assign** to assign multiple registrants to one location in a modal

Each assignment tracks registrant IDs, location, check-in/out dates, party-together flag, special needs, and cost.

### Host Links

On each location with a host:

* **Email Dashboard to Host** — Emails the public host dashboard URL
* **Copy Public Link** / **Copy Internal Link** — Copy dashboard URLs

See [Host Dashboard](/ChurchBuddy/Events/host-dashboard) for the public URL format.

## Host Dashboard

Send hosts the public link (includes `host_token`):

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

When the host opens the link they see location info, assigned guests, and (if **Share Guest Info with Host** is enabled) guest contact details.

## Exporting Housing Data

1. Go to **Logistics → Housing**
2. Click **Export**
3. Downloads **CSV** only (`/housing/export?format=csv`)

## Best Practices

1. Create locations before registration opens
2. Set accurate capacity and overbook limits
3. Use **Bulk Assign** for large groups
4. **Email Dashboard to Host** early so hosts can prepare
5. Export CSV before event day as backup

## Troubleshooting

**Capacity exceeded:** Check occupancy vs capacity and overbook limit.

**Can't assign guest:** Verify registration and location capacity.

**Host dashboard empty:** Enable **Share Guest Info with Host** and confirm assignments exist for that location.