Getting Started

Ezoic Subscriptions helps you launch paid access without building checkout, subscriber sessions, payment handling, or account management from scratch. The implementation is centered on the onsite script: your site checks an access key, reveals protected content when access is allowed, and opens Ezoic checkout when access is needed.

Before You Start 🔗

You need:

  1. The ability to edit your site HTML, templates, theme, or application code.
  2. Access to Ezoic Subscriptions setup in your Ezoic account.
  3. Completed payment onboarding so checkout can sell access.
  4. A publisher-managed offer with an access key (such as premium-access) and an offer key (such as premium-plan).
  5. A clear decision about what content or features subscribers should receive.

If someone else maintains your site, share the integration guides with them before launch.

Key Concepts 🔗

Offer: What visitors buy. An offer can contain one or more subscription tiers, and you can create more than one offer per site.

Tier: A membership level inside an offer, such as Premium or Pro.

Access key: The developer-facing key your site checks with hasAccess(...) to decide whether to show protected content. For example, a tier named Premium Access might use the access key premium-access.

Offer key: The developer-facing key your site passes to showPaywall({ offer }) to open checkout for a specific offer. For example, an offer named Premium Membership might use the offer key premium-plan.

Donation: Optional reader support that does not unlock pages or grant access. Donations are currently pay-what-you-want in USD above a minimum amount you set.

Subscriber portal: The account area at https://subscriber.ezoic.com where subscribers can manage subscriptions, receipts, invoices, and payment methods.

Setup Checklist 🔗

  1. Complete payment onboarding in your Ezoic account.
  2. Create a publisher-managed offer and note its access key and offer key.
  3. Add https://sm.ezoic.com/min.js to pages where subscriptions or donations should work.
  4. Use ezsubscriptions.hasAccess("access-key") to decide whether to show full content.
  5. Call ezsubscriptions.showPaywall({ offer: "offer-key" }) when access is not allowed.
  6. Add paywalled-content structured data before launch.
  7. Optionally mount donations with ezsubscriptions.showDonations().
  8. Verify checkout, login, and the subscriber portal before announcing paid access.

Next Steps 🔗