Metered Paywalls & Registration Walls

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.

Outpost’s paywall system lets you limit how many posts a reader can view before they’re prompted to sign up (registration wall) or upgrade to a paid subscription (metered paywall). This is configured through the Auto Display system’s Registration/Metered Wall slot.

​

How it works

Outpost tracks how many unique posts each reader has viewed. When their view count exceeds the configured limit, a paywall popup appears instead of the post content. The limit means “up to N posts” — the wall appears on post N+1. For example, if the limit is set to 10, the reader can view 10 posts freely and the paywall appears on the 11th post. The paywall slot is disabled by default and must be enabled in Auto Display before it takes effect. Paid and complimentary members bypass the metered paywall entirely — it only applies to unknown visitors and free members. There are two independent walls: Both can run simultaneously — a reader might hit the registration wall first, sign up for free, and later hit the metered paywall.

​

Setting up the paywall

Go to CTAs/Buttons/Popups → Auto Display, then click the Registration/Metered Wall tab.

​

Assigning audiences

The Assign section has two audience rows, each with an enable toggle and a CTA dropdown:

• Unknown Audience — toggle on to enable the registration wall, then pick a subscribe-style paywall popup (e.g., “Paywall Popup Modern - Subscribe”).
• Free Audience — toggle on to enable the metered paywall, then pick an upgrade-style paywall popup (e.g., “Paywall Popup Modern - Upgrade”).

Toggle either row off to disable that wall on its own, or toggle both off to turn metering off entirely while leaving other Auto Display slots running.

​

Article limits

The Settings section has the post-count fields:

​

Display trigger

Choose when the paywall appears on a metered post:

​

Tag exclusions

Use Don’t show on posts with tags to exempt specific posts from metering. For example, tag your most important posts with #free-access and add that tag to the exclusion list so they’re always accessible.

​

Editing the paywall popups

Edit the popup content (headline, body text, button text) in the CTA Library under the Registration/Metered Wall tab.

​

Real-time stats

A stats panel at the top of the tab shows live counts:

• The Registration Wall has been shown N times — total displays to unknown visitors.
• The Metered Paywall has been shown N times — total displays to free members.
• Free signups after hitting the Registration Wall, with click-through rate.
• Paid upgrades after hitting the Metered Paywall, with click-through rate.

For a deeper view across all CTAs, see the CTA Dashboard.

​

Ghost native paywalls

Ghost also supports content-level gating via the <!--members-only--> tag in posts. Content below this tag is hidden from non-members. Outpost’s metered paywall is a separate, complementary system: Both systems can be used together — Ghost’s native gating for specific premium posts, and Outpost’s metered wall for site-wide article limits. Posts that are already gated natively in Ghost (with visibility set to “members,” “paid,” or specific tiers) are automatically excluded from Outpost’s metered paywall, so readers are never double-gated.

​

Customizing the paywall appearance

Paywall popup design inherits from your Default Design settings. You can also customize individual paywall CTA styles in the Library under the Registration/Metered Wall tab.

​

Debugging the paywall

If the paywall doesn’t appear as expected, you can enable debug logging by adding ?outpost_debug=1 to any page URL on your site (e.g., https://yoursite.com/some-post?outpost_debug=1). This makes Outpost output detailed information to your browser console explaining:

• Whether the paywall slot is enabled
• The current visitor’s post view count and what their limit is
• Why the paywall did or did not appear on that page
• Whether the post was excluded by a tag rule or site-wide exclusion

Open your browser’s developer tools (F12 → Console tab) after adding the query parameter to see the output.

---

​

Frequently asked questions

---

​

Related features