Announcements

Send email blasts and display site banners to keep attendees informed.

Quick outcome

Announcements let organizers communicate with attendees through two channels: email messages sent via Mailgun, and banners displayed on the event site. You can target specific groups of attendees and track delivery status.

Setup

Announcements require Mailgun credentials for email delivery. Verify these are configured in your environment:

• MAILGUN_API_KEY
• MAILGUN_DOMAIN

Email sender address is configured in Event Settings (emailFrom and emailReplyTo fields).

Day-to-day management

Creating an announcement

Navigate to /admin/announcements/new:

Field	Description
Subject	Email subject line / banner title
Body	Message content (HTML supported)
Delivery type	email only, banner only, or both

Email targeting

Filter	Recipients
All	Every allowed email
Confirmed	Only confirmed RSVP contacts
Tentative	Only tentative RSVP contacts
Custom	Manually specified email list

The system builds the recipient list from the selected filter and shows the count before sending.

Banner configuration

For banner delivery:

Field	Description
Banner active	Toggle visibility
Priority	info, warning, or urgent (affects styling)
Expires at	Auto-dismiss date
Dismissible	Whether attendees can close the banner

Managing announcements

View all announcements at /admin/announcements:

• See status (draft, sending, sent, failed)
• Click to edit at /admin/announcements/[id]
• Toggle banner visibility
• Review recipient count and delivery status

Sending flow

1. Create a draft announcement
2. Configure recipients and delivery type
3. Preview the message
4. Click send — status changes to sending
5. Emails dispatched via Mailgun
6. Status updates to sent (or failed with error message)

Attendee experience

• Email announcements: Arrive in attendees' inboxes from the configured sender address
• Banners: Display at the top of event pages with the configured priority styling
  • info — neutral/blue banner
  • warning — yellow/orange banner
  • urgent — red banner
• Dismissible banners can be closed by attendees; non-dismissible ones persist until the organizer deactivates them or they expire

Troubleshooting

Symptom	Fix
Emails not sending	Verify Mailgun credentials and sender domain health
Banner not visible	Check bannerActive flag and expiration date
Wrong recipients	Review the recipient filter and verify the generated list before sending
Send failed	Check the error message in the announcement record; common issues are Mailgun auth or domain verification
Emails going to spam	Verify SPF/DKIM records for the Mailgun sending domain

Next steps

• Event Settings — configure sender email address
• People & Access — manage the recipient pool
• Environment Variables — Mailgun configuration