While Auto Display places CTAs automatically, sometimes you need a specific button in a specific place. The Manually Added Buttons page lets you generate custom CTA buttons with embed code that you paste into Ghost posts, emails, or any HTML page.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.
Button types
Choose from four CTA button types across the top tabs:| Type | Purpose |
|---|---|
| Tip Button | A one-time donation button linked to your Tip Jar |
| Intelligent CTA Button | A button whose text and action change based on the reader’s membership status (requires Luna plan) |
| Gift Sub Button | A button to purchase a Gift Subscription |
| Multitier Custom Link | A button linking to a tier selection page |
Intelligent CTA Button sub-types
When you select Intelligent CTA Button, you choose which audience variant to generate. Each produces a different button that targets a specific reader segment:| Sub-type | Who sees the CTA |
|---|---|
| Unknown Members | Only anonymous (not logged-in) readers |
| Not Supporters | Unknown readers and logged-in free members; monthly, annual, and complimentary members see nothing |
| All Members | Every reader regardless of membership status |
| Paid Only | Only paying members (including complimentary); unknown and free readers see nothing |
Customizing button text and action per member level
Within each Intelligent CTA Button, you can configure a separate button text and action for each membership level (Unknown, Free, Monthly, Annual, Complimentary). For each level, the available actions are: Subscribe to Free, Upgrade to Paid, Upgrade to Annual, Donate, or Give Gift Subscription. Changes to button text and action are universal and retroactive — existing buttons on posts update automatically when you save.Ghost Snippets (Luna plan)
On the Luna plan, all four Intelligent CTA Button variants are automatically added to your Ghost editor as Snippets. To insert a button, click the + button in the Ghost post editor and scroll to Snippets. This means you don’t need to copy and paste embed code for each post — just select the snippet you want.Visibility options
Control where and to whom the button is shown:| Visibility | Description |
|---|---|
| Posts Only - all members | Shows in Ghost posts to all readers |
| Posts Only - paid members | Shows in Ghost posts only to paid subscribers |
| Emails Only | Shows in Outpost-sent emails only |
| Emails/Posts - all members | Shows in both Ghost posts and emails to everyone |
Not all visibility options are available for every button type. Tip Button and Gift Sub Button support all four options. Intelligent CTA Button and Multitier Custom Link only support “Posts Only” visibility.
Configuring a button
Text and URL
| Field | Description |
|---|---|
| Dynamic Text | The button label readers see. For Tip Button and Gift Sub Button, text changes apply site-wide to all instances. For other types, you’ll need to re-copy the embed code after changing text. |
| URL | Auto-generated based on your button type and site settings. Displays markup variables %BLOG_PATH% (your site URL) and %BLOG_NAME% (your publication name) for reference. |
Display settings
| Setting | Description |
|---|---|
| Button Background | Choose a color, or check “Use default Ghost color” to inherit your site’s accent color |
| Button Text | Text color |
| Font | Select a font family |
| Size | Font size in pixels (e.g., 18 px) |
Getting the embed code
The right side panel shows the Raw HTML for Ghost Editor — the generated HTML code for your button. Click Copy to copy it to your clipboard, then paste it into:- A Ghost post using an HTML card (Post Editor → + → Raw HTML)
- An Outpost email template
- Any external HTML page
Using on external sites
Outpost’s embed script can be added to any HTML page outside Ghost. This lets you add subscription buttons and widgets to:- Email campaign landing pages
- Podcast episode pages
- Course or event registration pages
- Webflow sites
- Co-branded signup pages with partners
- Anonymous visitors — See subscribe prompts
- Free members — See upgrade prompts
- Paid members — See thank-you or access-granted states
Frequently asked questions
What's the difference between Manually Added Buttons and Auto Display CTAs?
What's the difference between Manually Added Buttons and Auto Display CTAs?
If I change the button text, do I need to update every post where I used the button?
If I change the button text, do I need to update every post where I used the button?
Can I use Manually Added Buttons in emails?
Can I use Manually Added Buttons in emails?
Do Manually Added Buttons work if Auto Display is turned off?
Do Manually Added Buttons work if Auto Display is turned off?
What does the Intelligent CTA Button do differently from a regular button?
What does the Intelligent CTA Button do differently from a regular button?
Related features
Auto Display CTAs
Automatically place CTAs without manual embedding
Tip Jar
Set up the Tip Jar that powers Tip Buttons
Gift Subscriptions
Configure gift subscriptions linked by Gift Sub Buttons