Skip to main content

​
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
There is no Host Requires Account or Host Account Email field in the location modal — hosts use the public dashboard link with host_token.

​
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. 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 for the public URL format.

​
Host Dashboard

Send hosts the public link (includes host_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.