Host an Event
Host an Event pages allow supporters to submit events that, once approved by a Team Member, become full event sessions on your map. This is useful for distributed organizing where you want supporters to host their own house meetings, watch parties, canvass launches, or other community gatherings tied to a central campaign event.
The page combines a page builder layout (with a header, event map, and other sections) with a submission form where supporters provide their event details. Submissions go through a moderation workflow before appearing publicly.
How It Works
- Supporter visits the page and sees a header, a map of existing approved events, and a submission form
- Supporter fills out the form with their name, email, phone, event address (selected from a geocoded dropdown), date, start/end time, and an optional description
- Submission is held for moderation and appears in the Host an Event page dashboard's Submissions tab
- A Team Member approves or rejects the submission
- On approval, a new event session is created with the submitted details, the host is automatically RSVP'd, and an optional approval email is sent to the host with their event details, RSVP share link, and Host Tools link
Creating a Host an Event Page
Host an Event is a page type available from the standard page creation flow.
- Go to Pages → New Page
- In the Action Forms section, select Host an Event
- Choose which Event to link the page to (only events that already have an Event Page and at least one future session are shown)
- Give the page a name and URL slug
- Click Create
The page is created with default sections: a header, an events map showing existing sessions for the linked event, and the submission form. All sections are editable in the page builder, though the Form and Events sections cannot be deleted.
The linked event must already have an Event Page (RSVP page) and at least one future session before you can create a Host an Event page for it. This ensures that approved submissions can generate working RSVP links.
The Submission Form
The form comes pre-configured with the following fields:
- Full Name (required)
- Email (required)
- Phone Number (required)
- Event Address (required, with geocoded address autocomplete to ensure valid coordinates)
- Event Date (required)
- Start Time (required)
- End Time (required)
- Event Description (optional)
The address field requires supporters to select an address from the autocomplete dropdown, ensuring every submitted event has valid map coordinates. If a supporter manually edits the address fields after selecting from the dropdown, the coordinates are cleared and the submission will be rejected.
Address fields submitted through this form are used for the event location only. They do not overwrite the supporter's personal address in the CRM.
Moderating Submissions
When a Host an Event page exists, a Submissions tab appears on that page's dashboard. This tab shows all submissions organized into three categories: Pending, Approved, and Rejected.
Reviewing a Submission
Each pending submission shows the submitter's name, email, and when it was submitted. Expand the submission to see the event date, start and end time, location, description, and phone number when available.
Approving a Submission
Click Approve on a pending submission. This triggers the following:
- A new event session is created on the linked event with the submitted date, time, location, and description
- The submitter is automatically RSVP'd to their new session
- If the Host Approval Email is enabled, the submitter receives an email with their event details and links
Rejecting a Submission
Click Reject to decline a submission. No event session is created. The submission moves to the Rejected section.
Each submission can only be moderated once. After approval or rejection, the action cannot be undone from this interface.
If there are pending submissions, the Submissions tab shows a yellow badge with the pending count.
Host Approval Email
When a submission is approved, you can automatically send the host a configurable email with their event details. This email is configured in the Details tab of the Host an Event page dashboard, under the Host Approval Email collapsible section.
Configuring the Email
The approval email editor uses the same rich text editor as other platform emails. You can customize the subject line and body content, and select which email wrapper and sender to use.
Available Merge Tags
The approval email supports the following merge tags in addition to the standard user merge tags:
| Merge Tag | Description |
|---|---|
{{ event.title }} | The parent event's title |
{{ event-session.start-time }} | The approved session's start time |
{{ event-session.end-time }} | The approved session's end time |
{{ event-session.location-address }} | The approved session's address |
{{ rsvp-share-url }} | A direct link to the event page with the new session pre-selected |
{{ host-tools-url }} | The Host Tools link for the session (if Host Tools is enabled on the event) |
Enabling or Disabling
The approval email is enabled by default when the page is created. You can toggle it on or off from the same section. When disabled, no email is sent on approval, but the event session is still created.
The{{ host-tools-url }}tag only produces a link if Host Tools is enabled on the parent event. If Host Tools is not enabled, the tag renders as empty. Use Liquid conditionals in your template if you want to conditionally show the Host Tools section.
Page Builder Defaults
Host an Event pages are created with sensible defaults that you can customize in the page builder:
- Header: Full-overlay layout with the page title centered over the background image
- Events Section: Map view showing existing approved sessions for the linked event
- Form Section: Centered layout with visible field labels and no sidebar image
The Form and Events sections are locked and cannot be removed from the page. The form always references the page's own submission form and the form selector is disabled, but you can still customize the form's appearance and the surrounding page content.
Admin Notifications
When a new submission comes in, Team Members receive notifications through the standard admin notification system configured on the page's Post-Submission tab. This uses the same notification infrastructure as other form submissions, so you can configure which admins receive email or SMS alerts for new submissions.
Tips
- Unpublishing the page is the simplest way to stop accepting new event submissions. There is no separate toggle; the page's published state controls whether the form is accessible.
- Multiple responses are enabled by default, so the same supporter can submit more than one event.
- The events map on the page updates automatically as submissions are approved and new sessions are created.
- Supporters see existing approved events on the map when they visit the page, helping them decide whether to host in an area that needs coverage.
Updated about 2 hours ago
