Labels are free-form tags you apply to members. They drive segmentation across Outpost and Ghost — email campaigns, email flows, the Rules Engine, CTAs, and member filters all use labels to target the right audience.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.
Creating labels
Labels are created the moment you apply them to a member or use them as a filter. There’s no separate “create label” step — just type the label name and it’s created in Ghost. Outpost shows all existing labels via autocomplete as you type, so you don’t accidentally create duplicates.Applying labels
Labels can be applied to members in several ways:- Manually — Type a label name into any label field in Outpost. The autocomplete suggests existing labels as you type, and you can click Add New to create a label that doesn’t exist yet.
- Auto-applied Outpost labels — Outpost applies labels automatically in a number of situations:
- New members get a
Marketing_Okaylabel so they can receive marketing emails. - Donors get a
Gave_A_Donationlabel. - Sign-up CTAs, UTM parameters on the link they arrived from, events they RSVP’d to, gift subscription givers and recipients, and group subscription members all get specific labels.
- See the system label reference for the full list.
- New members get a
- Import — Include a
labelscolumn in your CSV import in Ghost to apply labels to members in bulk during import, or use the tool to add a label in Ghost. We recommend making the label first on a test user to make this process easier. - Email Flows — Include or exclude members from email sequences based on their labels. Flows can also be configured to target members by label.
- CTAs, Events and Gated PDFs — When a member interacts with a CTA or downloads a gated PDF, labels can be applied automatically. You can configure separate labels for new subscribers and existing subscribers.
- Contact Form — Outpost’s theme contact form accepts an optional
labelsarray on submission. Any labels included are applied to the member created (or matched) by the form, so you can tag inbound contacts by topic, source page, or campaign.
Label-based segmentation
Labels are used throughout Outpost to segment your audience. Anywhere you can target members, you can filter by labels:In email flows
Each email flow section has two label filters:- Only Include Members Labeled — Only members who have one or more of these labels will receive the emails in this flow.
- Exclude Members Labeled — Members who have any of these labels will be skipped, even if they match all other criteria.
In email campaigns
Email campaigns have the same include/exclude label filters as email flows. When you mark a campaign as a marketing email, Outpost automatically adds theMarketing_OptOut label to the exclusion list so members who have opted out of marketing will not receive the campaign.
In the Rules Engine
The Rules Engine is a Labs feature that subscribes or unsubscribes members from newsletters when a label is added or removed. Labels themselves are the trigger — Rules Engine actions don’t add or remove labels.In CTAs
CTA audience targeting supports label-based inclusion and exclusion, letting you show different conversion offers to different segments of your audience.Labels as automation triggers
Labels are one of the primary triggers for email flows and campaigns. When a label is added to or removed from a member, it can:- Start an email sequence
- Remove the member from a sequence
- Send a notification to an external service
- Apply another label
at-risk label to a member could trigger an Advanced retention email flow, and removing it could stop the flow.
Automatic labeling with CTAs, Events and gated PDFs
When you set up a CTA or gated PDF, you can configure labels to be applied automatically when members interact with the content:- Label New Subscribers — Labels applied to members who sign up through this CTA (first-time subscribers).
- Label Existing Subscribers — Labels applied to members who are already subscribed when they interact with this CTA.
Labels in Ghost
Label sync between Outpost and Ghost works in both directions:- Outpost to Ghost — Labels applied in Outpost are automatically synced to Ghost, so you can use them for Ghost-native features like newsletter segments.
- Ghost to Outpost — Labels applied in Ghost sync back to Outpost, keeping both systems in alignment.
System labels
Outpost automatically applies labels to members as they move through subscription and conversion events. These system labels track lifecycle milestones like:Active_Client— Member has an active paid subscriptionFormer_Paid_Subscriber— Member previously had a paid subscriptionGave_A_Donation— Member made a one-time donationReceived_Gift_Subscription— Member received a gift subscriptionMarketing_OptOut— Member has opted out of marketing emails
Best practices
- Pair labels with Advanced email flows — Applying a label starts the sequence; removing it stops it. This gives you a simple on/off switch for automations.
- Let CTAs apply labels automatically — Configure your CTAs and gated PDFs to label members on interaction. This builds your segmentation data without manual effort.
- Avoid too many one-off labels — Consolidate into a clean taxonomy over time. It’s easier to manage 20 well-named labels than 200 ad hoc ones.
System labels follow a
Title_Case_With_Underscores naming pattern (e.g., Active_Client, Marketing_OptOut). Your custom labels can follow any naming style you prefer, but be aware that label matching is case-sensitive.Related features
Email Flows
Automated email sequences triggered by labels and member events.
Rules Engine
Subscribe or unsubscribe members from newsletters automatically when labels change.
Email Campaigns
Send one-time emails to label-based audience segments.
System Label Reference
Complete list of labels Outpost applies automatically.
FAQ
Do I need to create labels before using them?
Do I need to create labels before using them?
No. Labels are created automatically when you type a new name into any label field. Outpost remembers all labels you’ve used and offers them via autocomplete in the future.
Are labels synced with Ghost?
Are labels synced with Ghost?
Yes. Labels sync bidirectionally between Outpost and Ghost. A label applied in either system will appear in both.
Can I use labels to target email campaigns?
Can I use labels to target email campaigns?
Yes. Both email flows and email campaigns support label-based include and exclude filters. You can target members who have specific labels and exclude members who have others.
What's the difference between system labels and custom labels?
What's the difference between system labels and custom labels?
System labels are applied automatically by Outpost when members go through lifecycle events (subscribing, canceling, receiving a gift, etc.). Custom labels are ones you create and apply yourself. Both types work the same way in filters and automation triggers.
Can labels be applied automatically when someone interacts with a CTA?
Can labels be applied automatically when someone interacts with a CTA?
Yes. When configuring a CTA or gated PDF, you can set labels to be applied automatically to new subscribers and existing subscribers who interact with the content.
Are labels case-sensitive?
Are labels case-sensitive?
Yes.
Premium and premium would be treated as two different labels. Use a consistent naming convention to avoid duplicates.
