FAQ

Choosing an integration

Which integration should I use?

For Ghost sites, use Ghost. It is the only integration that can restore the full post. For the default wall with no code, use Standalone. To match your own design, or to present Paperwall alongside your own subscription offer, use BYO Wall.

Can Paperwall run alongside an existing subscription paywall?

Yes. This is the usual reason to choose BYO Wall. Paperwall reports whether the reader has paid for the current article; what you display alongside that result, including your own subscription offer, is up to you.

Do readers have to use tickets?

Yes. Readers pay in tickets and articles are priced in tickets. The monetary value of a ticket depends on your site's currency.

Installation

How do I confirm the script is live?

Open the page in your browser's inspector and check that the Paperwall script tag is present and has executed. If the tag is present but nothing runs, check the console for a content security policy or integrity error.

Is my content security policy blocking the script?

This is likely if nothing loads at all. Add https://paperwall.io and https://assets.paperwall.io to your script-src directive.

Can I change the src or integrity values in the snippet?

No. The two values are a pair, pinned to a loader build that has been fetched and hashed. Changing either one causes the browser to refuse to execute the script, resulting in no wall and no reporting. Use the snippet from the portal without modification.

Is my site token a secret?

No. The site token is public and appears in your page source; it only identifies your site. Your Ghost admin key is a secret, is stored encrypted, and is never sent to the browser.

The wall

Why is the wall not appearing on my article?

Check articleFinder first. Either the URL matches none of your postUrls regular expressions, or selector matches no element on the page. Both checks run in the browser before any network call, so an empty network tab points to this.

Then check whether the site is in PREVIEW, in which case the wall appears only to your team, and whether the article is below its threshold, in which case it is free and behaving as configured.

Why is the wall appearing on pages that are not articles?

The postUrls pattern is too broad. Narrow it, or add an excludeUrls list for the pages it incorrectly matches. Sites that serve posts at the root, such as Ghost, need particular care here.

Why is my article free?

Either its threshold has not been reached, or its cost is set to 0. Both are in the article's Wall Settings.

What is preview mode?

A verified site that has not yet been published. The wall runs for members of your Paperwall team only; all other readers see your articles unchanged. Use it to check the wall before readers see it.

What is promo mode?

The Promote Paperwall setting. When enabled, a reader who unlocks an article sees a one-time invitation to visit paperwall.io. It is enabled by default and can be turned off in site settings.

Payment

When can I take payment?

Once your site is LIVE. That requires verification and, if you use an integration, valid saved credentials. Redemption is refused in any other state.

How do I get paid?

Connect a Stripe account under Payouts in your site settings. See Site configuration.

Is a reader charged again later?

No. Access is linked to the reader's account and does not expire or renew. No further charge is made unless they unlock another article.

Can readers unlock articles without an account?

Only free articles. Any article with a cost requires an account and a saved card.

Ghost

Why does Ghost need an admin key when other platforms do not?

Ghost truncates members-only posts on the server, so the rest of the article never reaches the browser and no paywall can reveal it. Paperwall must read the full post from your installation and add it to the page after payment.

I regenerated my Ghost key and unlocks stopped working.

Regenerating the key in Ghost invalidates the copy stored in Paperwall. Enter the new key in your Paperwall integration settings.

A reader unlocked an article and received an empty page.

Check the admin key, then the saved Ghost URL, then whether the post is published. See Ghost.