> ## 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.

# Auto Display Calls To Action (CTAs)

> Place CTAs across your Ghost site automatically based on slot, audience, and tag — no per-post embedding required.

Auto Display is Outpost's system for automatically placing conversion widgets (CTAs) on your site. Instead of manually adding code to every Ghost post, you configure slots and audience targeting once, and Outpost handles the rest — showing the right CTA to the right reader at the right time.

**Auto Display CTAs are website-only.** They do not show up in your Ghost newsletters unless someone clicks to read on the web.

<Frame caption="The Auto Display page with the master toggle, slot tabs, and audience targeting">
  <img src="https://mintcdn.com/outpost-eb0cfbad/7Kq7FfrXdvKAXGxP/images/ctas/auto-display-main.png?fit=max&auto=format&n=7Kq7FfrXdvKAXGxP&q=85&s=f051532d4a24acd380e1998f899f5df7" alt="Auto Display page showing the master toggle, the top section selector (Auto Display Slots, Library, Default Design, Site-Wide Exclusions), and slot type tabs (In-Post, Post Popup, Post Slide Up, Homepage Popup, Registration/Metered Wall, Gated Download)" width="1919" height="2897" data-path="images/ctas/auto-display-main.png" />
</Frame>

<Note>
  Auto Display is available on the Voyager and Luna plans. It is not available on the Space Station plan.
</Note>

<Note>
  **CTAs are sign-up nudges, not access control.** They show on top of every post regardless of whether the post is public, registered-only, or paid. Whether a post is locked is set per-post in Ghost (and optionally enforced by Outpost's [Registration Wall](/features/paywalls)). A CTA might prompt an unknown reader to sign up for the free newsletter on the same page where Ghost is gating the paid content behind a paywall — the two systems work together but do different jobs.
</Note>

## How it works

1. **Slots** define *where* a CTA appears — at the top of a post, as a popup, as a slide-up banner, on the homepage, or as a metered paywall
2. **Audiences** define *who* sees it — unknown visitors, free members, monthly subscribers or annual subscribers
3. **CTAs** define *what* they see — a subscribe box, an upgrade prompt, a discount offer, a donation button, or a prompt to give a gift subscription
4. **The Auto Display master toggle** at the top of the page enables or disables the entire Auto Display system in one click

## The four sections

The Auto Display page has four sections, switched via the selector at the top of the page:

| Tab                      | Purpose                                                             | Documented in                                                 |
| ------------------------ | ------------------------------------------------------------------- | ------------------------------------------------------------- |
| **Auto Display Slots**   | Configure where and to whom CTAs appear                             | [Slots & Targeting](/features/cta-slots#auto-display-slots)   |
| **Library**              | Browse, edit, and enable the CTA templates available for assignment | [Library & Styling](/features/cta-library#library)            |
| **Default Design**       | Set global colors, fonts, and button styles for all CTAs            | [Library & Styling](/features/cta-library#default-design)     |
| **Site-Wide Exclusions** | Exclude specific post tags or URL refs from showing any CTAs        | [Slots & Targeting](/features/cta-slots#site-wide-exclusions) |

<CardGroup cols={2}>
  <Card title="Slots & Targeting" icon="bullseye" href="/features/cta-slots">
    The six slot types, audience targeting, tag-based variants, and site-wide exclusions
  </Card>

  <Card title="Library & Styling" icon="palette" href="/features/cta-library">
    Browse and enable CTA templates, edit their content, and style them with default design or custom CSS
  </Card>

  <Card title="Traffic Source Tracking" icon="bullseye-arrow" href="/features/traffic-source-attribution">
    Attribute signups to campaigns and channels with UTM and referral labels
  </Card>

  <Card title="CTA Dashboard" icon="chart-bar" href="/features/cta-dashboard">
    View analytics across all your CTAs
  </Card>
</CardGroup>

## Conversion tracking

Outpost tracks performance for the Registration/Metered Wall and Gated Download slots with built-in stats:

* **Wall/paywall shows** — How many times the CTA was displayed
* **Signups** — Free member registrations triggered by the registration wall
* **Upgrades** — Paid conversions triggered by the metered paywall
* **Click-through rate** — Conversion percentage

For broader CTA analytics across all slot types, see the [CTA Dashboard](/features/cta-dashboard). To attribute signups to specific campaigns and channels, see [Traffic Source Tracking](/features/traffic-source-attribution).

## CTA cloning

You can duplicate any existing CTA using the clone feature. This creates a copy with the same settings and design, which you can then customize independently — useful for creating variations or reusing a CTA as a starting point. A cloned CTA's [Custom CSS](/features/cta-library#custom-css) is copied and automatically re-scoped to the new copy. The clone starts **inactive** and isn't assigned to any slot or audience, so it won't serve to readers until you activate it and place it yourself.

## A/B testing

There is no built-in randomized A/B testing. However, you can approximate A/B tests by creating two CTAs with different copy or designs in the [Library](/features/cta-library), then assigning them to the same slot for different tag-based content. Compare conversion rates manually to determine which performs better. Confirm you have enough data before drawing conclusions.

## Frequently asked questions

<AccordionGroup>
  <Accordion title="What does the Auto Display master toggle do exactly?">
    The Auto Display master toggle enables or disables the entire Auto Display system in one click. It affects all Auto Display slots (In-Post, Popups, Slide Ups, Homepage Popups, Registration/Metered Wall, and Gated Downloads). It does **not** affect Manually Added Buttons that you've pasted into Ghost posts — those are independent of Auto Display.
  </Accordion>

  <Accordion title="I turned on Auto Display but nothing is showing on my site. What's wrong?">
    Check four things: (1) The Auto Display master toggle must be on. (2) The individual audience toggles within your slot must be enabled, and a CTA must be selected from the dropdown for each audience. (3) Make sure you aren't logged in as a paid member (you won't see the unknown or free CTAs). (4) Check the Theme Connection Wizard to confirm your theme is connected to Outpost.
  </Accordion>

  <Accordion title="Do I have to use all three In-Post slots?">
    No. You can use one, two, or all three. Each slot is independently configurable with its own position, audiences, and toggle. Disable the ones you don't need.
  </Accordion>

  <Accordion title="What's the difference between Site-Wide Exclusions and per-slot tag exclusions?">
    Site-Wide Exclusions apply globally across every slot — if you add a tag there, no Auto Display CTA of any kind will appear on posts with that tag. Per-slot tag exclusions only affect that one specific slot. Both work together — a post can be excluded by either setting.
  </Accordion>

  <Accordion title="What are URL ref exclusions used for?">
    URL ref exclusions suppress CTAs for readers arriving via specific referral parameters. For example, if your newsletter links include `?ref=newsletter`, adding "newsletter" to the exclusion list prevents subscribe popups from showing to readers who clicked through from email (since they're likely already subscribed). Note that this ref is tied to the name of your newsletter, so don't just add "newsletter" — check your newsletters' refs.
  </Accordion>

  <Accordion title="I edited a CTA in the Library but it's not showing on my site. Why?">
    CTAs must be both enabled in the Library **and** assigned to a slot. Editing a CTA doesn't automatically assign it anywhere. Go to Auto Display Slots, pick the slot you want, and select that CTA from the dropdown for the relevant audience.
  </Accordion>

  <Accordion title="Can I make CTAs match my site's branding?">
    Yes. The Default Design tab lets you set global accent colors, button fonts, border radius, and text fonts that apply to all CTAs. If you want a specific CTA to look different, you can override the default on that individual CTA using the Design settings in the Library.
  </Accordion>
</AccordionGroup>

## Related features

<CardGroup cols={2}>
  <Card title="Gated PDFs" icon="file-pdf" href="/features/gated-pdfs">
    Offer downloadable files exclusively to subscribers
  </Card>

  <Card title="Paywalls" icon="lock" href="/features/paywalls">
    Meter content access and prompt upgrades
  </Card>

  <Card title="Manually Added Buttons" icon="code" href="/features/manually-added-buttons">
    Generate embed code for buttons you place manually in posts
  </Card>

  <Card title="CTA Dashboard" icon="chart-bar" href="/features/cta-dashboard">
    View analytics across all your CTAs
  </Card>
</CardGroup>
