Documentation Index
Fetch the complete documentation index at: https://documentation.outpost.pub/llms.txt
Use this file to discover all available pages before exploring further.
Labs feature (Beta) — Events is available in Labs on the Luna plan. The feature is in active development and may change.

How it works
- Create an event in the Outpost dashboard with a name, date, time, and access settings.
- Publish to Ghost — Outpost creates a Ghost post with embedded registration code.
- Members register via the on-page widget, which handles login, access checks, and RSVP.
- Calendar links appear after registration so attendees can save the event.
- Attendee tracking records registrations and cancellations.
- Event countdown displays a live countdown to the event start time.
Creating an event
Go to Events (beta) under the Labs group in the left navigation and click Create Event. If your theme defines event types (e.g., “In-Person”, “Webinar”, “Virtual”), you’ll select the type first — this determines which fields and settings are available.Event details
| Field | Description |
|---|---|
| Name | The event title. Required. |
| Slug | Auto-generated from the name when you first save. Locked after that — the on-page Slug field is the event’s permanent identifier and won’t change if you rename the event later. |
| Short Description | Optional excerpt displayed in event listings. |
| Event Date | The date of the event. Required. |
| Start Time | When the event starts. Required. |
| End Time | When the event ends. Optional — if blank, Outpost falls back to the start time when deciding whether the event has passed. |
| Time Zone | Choose from all major IANA time zones. |
| Location | Where the event takes place (e.g., “Online”, a venue name). |
| Event Platform URL | Optional link to the event platform (e.g., Zoom). |
| Max Attendees | Optional cap on registrations. Leave blank for unlimited. |
Registration settings
| Field | Description |
|---|---|
| Featured Image | Upload an event image. Recommended dimensions are shown from your theme settings. |
| Registration Deadline | Optional cutoff date and time for new registrations. If blank, registration stays open until the event ends. |
| Who Can Register | Three options: All Members (Free + Paid), Free Members Only, or Paid Subscribers Only. |
| Label Registrants | Automatically apply selected labels to members who register. |
Event lifecycle
Events transition automatically through three states based on dates and times:Registration Open
The event date is in the future and the registration deadline (if set) hasn’t passed. Members can RSVP.
Registration Closed
The registration deadline has passed but the event hasn’t happened yet. New RSVPs are blocked.
Attendee management
Once an event has registrations, the event detail page shows an Attendees section with:- Member name and email
- Registration timestamp (
Registered At) - Export CSV button to download the attendee list (Name, Email, Registered At)
Calendar links
After registering, members see calendar buttons to add the event to their preferred platform:- ICS File Download (Apple Calendar, Outlook desktop)
- Google Calendar
- Outlook Web
- Yahoo Calendar
Ghost integration
Publishing
When you publish an event from Outpost, a Ghost post is created (or updated) with:- The event name as the post title.
- A placeholder body with a
<div class="outpost-ghost-event-container"/>element where the registration widget renders, plus the prompt “Put your event description here” — replace this with your own copy in Ghost. - A JSON payload of event details in the post’s
codeinjection_footfor themes to read (date, time, access level, registration state). - A custom post template if you’ve configured one in Event Settings or your theme manifest.
- The featured image uploaded to Ghost (uploaded once, on first sync).
Automatic ordering
Ghost normally displays posts by publish date, not event date. Outpost automatically reorders event posts so they appear in chronological event-date order on your site.Theme support
Compatible Ghost themes (like Gazet) read event details from thecodeinjection_foot payload to display event information, registration status, and sign-up buttons natively. The registration widget uses your AutoDisplay CTA design settings (accent colors, button styles, fonts).
RSVP labels
When a member registers, Outpost adds a label to their member record so you can segment and filter event attendees in both Outpost and Ghost. The label is built from the event name and the month it was created — for example, an event named “Spring Webinar” created in March 2026 produces the labelZZZ_RSVP_spring_webinar_2026_03.
The label is set once when the event is created. Renaming the event later does not update the label — existing registrants keep their original label, and new registrants receive the same label as everyone else on the event.
Labels are removed automatically when a member cancels their registration.
Event countdown
When an event has a date and start time configured, Outpost generates a live countdown displayed on the event page. The countdown adapts based on how far away the event is:- More than a day away — shows days and hours (e.g., “3d 5h”).
- Less than a day — shows hours and minutes (e.g., “2h 30m”).
- Less than an hour — shows minutes only (e.g., “45m”).
Event settings
Open global event defaults by clicking the Settings button on the Events list page.| Setting | Description |
|---|---|
| Default Tags | Ghost tags applied to all event posts. Multi-select — pick any number of tags. |
| Default Template | Custom Ghost post template for event pages. |
| Featured Image Size | Recommended width and height (in pixels) shown on the upload form. |
| Calendar Platforms | Which calendar link buttons to show after registration. |
| Use AutoDisplay Design | Inherit CTA styling from your AutoDisplay settings. |
Default messaging
Event Settings includes customizable messaging templates for each audience state:| State | When it shows |
|---|---|
| Can Register | Eligible member who hasn’t registered yet. |
| Login Required (Free) | Guest visitor on a free event. |
| Login Required (Paid) | Guest visitor on a paid event. |
| Upgrade Required | Free member viewing a paid event. |
| Registered/Confirmed | Member who has RSVP’d — includes calendar links, share options, and cancel button. |
| Registration Closed | Anyone viewing after the deadline. |
| Event Passed | Anyone viewing after the event. |
Event emails
Outpost can send emails to registrants at key moments in the event lifecycle. Event emails are managed through the Basic Autoresponder and use the same template system as other autoresponder actions.Enabling event emails
Event emails are controlled at two levels:- Blog-level toggle — Enable or disable event emails for your entire publication in Event Settings. Must be on for any event emails to send.
- Per-event override — Individual events can disable emails even when the blog-level toggle is on. Useful for informal events where you don’t want automated notifications.
Email types
| When it sends | Recipient | |
|---|---|---|
| Confirmation | Immediately when a member registers. | Registrant |
| Reminder 1 | Configurable hours before the event (default: 24 hours). | All registered members |
| Reminder 2 | Configurable hours before the event (default: 2 hours). | All registered members |
| Event Updated | When event details change after members have registered. | All registered members |
| Event Cancelled | When an event is cancelled. | All registered members |
| Post-Event Recap | After the event ends (within 3 days). | Publisher/staff |
Confirmation emails send regardless of a member’s email opt-out preference — they’re transactional. Reminder emails respect the member’s email preferences and will not send to members who have opted out.
Reminder configuration
Reminders are set at the blog level in Event Settings and can be overridden per event:| Setting | Default | Description |
|---|---|---|
| Reminder count | 2 | How many reminders to send (0, 1, or 2). |
| Reminder 1 timing | 24 hours before | When to send the first reminder. |
| Reminder 2 timing | 2 hours before | When to send the second reminder. |
Tracked fields for the update email
Outpost watches six fields and prompts you to send the Event Updated email if any of them change after registrations exist:- Event Date
- Start Time
- End Time
- Time Zone
- Location
- Event Platform URL
Customizing event email templates
Each event email has its own template in the Basic Autoresponder. Templates support event-specific merge tags:| Merge tag | What it inserts |
|---|---|
%EVENT_NAME% | The event name. |
%EVENT_DATE% | The event date. |
%EVENT_TIME% | The start time (and end time when set). |
%EVENT_LOCATION% | The location field. |
%EVENT_JOIN_LINK% | The Event Platform URL. |
%EVENT_DESCRIPTION% | The short description. |
%EVENT_URL% | Link to the event page on your Ghost site. |
%EVENT_CALENDAR_GOOGLE% | Add-to-Google-Calendar link. |
%EVENT_CALENDAR_ICS% | ICS file download link. |
%EVENT_CALENDAR_OUTLOOK% | Outlook Web add-to-calendar link. |
%EVENT_CALENDAR_YAHOO% | Yahoo Calendar add-to-calendar link. |
%EVENT_CANCEL_LINK% | Link the member can use to cancel their registration. |
Related features
Event Creator
Create reusable event HTML widgets to embed in Ghost posts.
Theme Connect Wizard
Connect your Ghost theme to enable event widgets and other Outpost features.
Labels
RSVP labels are auto-applied when members register for events.
Basic Autoresponder
Configure event email templates and reminder timing.
FAQ
What's the difference between Events and Event Creator?
What's the difference between Events and Event Creator?
Events (this page) creates full Ghost-integrated events with registration, attendee tracking, and lifecycle management. Event Creator is a simpler tool for creating reusable event HTML widgets that you paste into Ghost posts — no registration or attendee tracking.
Can I limit the number of registrations?
Can I limit the number of registrations?
Yes. Set the Max Attendees field when creating an event. Once the cap is reached, new registrations are blocked.
How do I export my attendee list?
How do I export my attendee list?
Open the event detail page, scroll to the Attendees section, and click Export CSV. The export includes name, email, and registration timestamp.
Do events work with any Ghost theme?
Do events work with any Ghost theme?
The registration widget works on any theme as long as the theme renders
codeinjection_foot and the placeholder <div class="outpost-ghost-event-container"/> is left in the post body. Themes specifically built for Outpost (like Gazet) provide richer event rendering using the metadata Outpost injects.What happens if I change the event date after publishing?
What happens if I change the event date after publishing?
Outpost updates the Ghost post and reorders all event posts so they display in chronological event-date order. If event emails are enabled and members have registered, Outpost detects the change and offers to send an update notification to all registrants.
How do I enable event emails?
How do I enable event emails?
Go to Event Settings and turn on the event emails toggle. Then make sure the corresponding actions are enabled in your Basic Autoresponder. You can also disable emails for individual events without turning off the blog-wide setting.
Can I customize the reminder timing?
Can I customize the reminder timing?
Yes. The default is two reminders: 24 hours and 2 hours before the event. You can change the timing and the count (0, 1, or 2) in Event Settings, and override these settings on individual events.
Will members who opted out of emails still get event confirmations?
Will members who opted out of emails still get event confirmations?
Yes. Confirmation emails are transactional and send regardless of email preferences. Reminder emails respect opt-out preferences and won’t go to members who have unsubscribed.

