

How to
- Create an event in the Outpost dashboard by clicking the blue Create Event button. Fill in a name, date, time, and access settings (including link and image if applicatble). Save, then the Create Draft Post in Ghost button will appear. This will open a draft post with an embedded registration code.
You should see confirmation in the top right corner after saving:
After saving, the “Create Draft Post” button will change into one that opens the draft page in a new tab:

- Publish to Ghost — Fill in any additional information you would like to share with your readers in the draft post that’s created, then publish to Ghost.
Note: It may not look like your event is there in the draft post of editor, but you can see the information you entered in your OCC is being stored in the Code Injection section of the post to be displayed in your event widget after publishing (if you’ve made changes to your template to display events).


- 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 (pictured below) and click Create Event.

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
What gets added to the calendar
Every platform receives the same core information, derived from the event you published:| Calendar field | Source |
|---|---|
| Title | {Site Name}: {Event Name} — your site’s name precedes the event title so members can spot the source at a glance when they have many events on their calendar. |
| Start / end | The event’s start and end times, converted to UTC. If you set a start time but no end time, the entry uses your site’s Default duration (60 minutes by default). |
| Time zone | The per-event time zone if set, otherwise your site’s time zone, then UTC as a final fallback. |
| Location | The event’s location, or your site’s Default location if the event has none. |
| Description | From {Site Name} followed by the event description (if one exists). The site attribution is always included, even when the event has no description text. |
| Status | CONFIRMED (ICS only). Not exposed by the Google, Outlook Web, or Yahoo URL formats. |
| Event link | A URL: line back to the event page on your site (ICS only). The Google, Outlook, and Yahoo handoff URLs don’t include a separate link field; the description carries it instead if you reference it there. |
ICS file specifics
The ICS download produces a standards-compliant file (RFC 5545) that Apple Calendar, Outlook desktop, Thunderbird, and other clients can import directly. Each entry includes:Google, Outlook, and Yahoo handoffs
These three buttons don’t generate a file — they open the platform’s “create event” form pre-filled via URL parameters. Every form receives:- The site-prefixed title (
{Site Name}: {Event Name}). - The event start and end times in UTC.
- The location.
- The description with the
From {Site Name}attribution.
| Platform | Endpoint | Parameters |
|---|---|---|
calendar.google.com/calendar/render | action=TEMPLATE, text, dates, details, location | |
| Outlook | outlook.live.com/calendar/0/deeplink/compose | path, rru=addevent, subject, startdt, enddt, body, location |
| Yahoo | calendar.yahoo.com/ | v=60, title, st, et, desc, in_loc |
STATUS or URL field via their compose URLs, so members get the title, time, location, and description; if you want the event page link to be discoverable from the calendar entry, include it in your event description.
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:- Site-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 site-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 site 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. |
Event templates also support the standard member, site, and subscription merge fields — plus fallback syntax for empty values like
%SUBSCRIBER_FIRST_NAME%,fallback="there". See Email templates for the full reference.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 site-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.

