PaddleSubs Documentation
Sell access, subscriptions and site licenses on Joomla with Paddle Billing
Copyright © 2026 JCH Optimize
| Revision History | |
|---|---|
| 2026-10-03 | |
| First edition, written for the PaddleSubs 0.0.1 development builds. | |
This book explains how to install, connect and run PaddleSubs, which sells access to your Joomla site through Paddle Billing. It is written for site owners who sell memberships, downloads, services or software and are comfortable in the Joomla administrator, but have not used Paddle before. It explains how Paddle and PaddleSubs share the work, walks you through selling your first subscription and protecting content with it, covers site licenses and importing customers from another system, and describes every page, setting, scheduled task and email, with a troubleshooting guide and a reference for developers.
- About This Book
- 1. Introduction
- 2. Installation, Updates, and Support
- 3. Getting Started
- 4. Understanding PaddleSubs
- Products, Prices and Levels
- Custom Products and Prices
- Access Subscriptions
- Access, Stacking and Licensed Products
- Automatic and Manual Renewal
- How Purchases Grant User Groups
- How Paddle Customers Become Joomla Users
- Refunds and Chargebacks
- What Is Stored on Your Site and What Stays in Paddle
- What Happens Without You
- Sandbox and Live Environments
- 5. Tutorial: Sell a Membership, From Paddle to Protected Content
- Step 1: Create the Group and the Access Level
- Step 2: Create a Level
- Step 3: Create the Product and Its Prices
- Step 4: Add the Pages Customers Use
- Step 5: Protect the Members' Articles
- Step 6: Invite Visitors to Join
- Step 7: Make a Test Purchase
- Step 8: Check What Happened
- Step 9: Test the End of a Membership
- Step 10: Go Live
- 6. Licenses and Site Activations
- 7. Importing From Another Subscription System
- What an Import Does and Doesn't Do
- Before You Import
- Step 1: Choose Where the Data Comes From
- Step 2: Say Where the Data Is
- Step 3: Decide What Each Price Becomes
- Step 4: Try It First
- Step 5: Import
- Where the Old Data Is Kept, and When It Is Deleted
- Importing a Newer Copy
- Rehearsing in the Sandbox
- Undoing an Import
- After the Import
- Mapping Profiles
- 8. How-to Guides
- Show a Price in an Article
- Link to a Product Page
- Show Content Only to Customers
- Release Content Over Time
- Offer a Discount Code
- Reward Existing Customers Automatically
- Sell a Custom Deal by Invoice or Payment Link
- Give One Tier Group to Several Products
- Fix Customers' Groups After Changing a Product
- Extend, Shorten or End Someone's Access
- Catch Up After Missed Webhooks
- List Products by Category or by Level
- Make the Pages Look Like Your Site
- Control Who Can Do What
- Switch Between Sandbox and Live
- 9. The Admin Pages
- Finding Your Way Around
- The Dashboard
- The Products Page
- The Product Editor
- The Categories Page
- The Levels Page
- The Discounts Page
- The Transactions Page
- The New Payment Link or Invoice Page
- The Access Subscriptions Page
- Granting Access by Hand
- The Access Subscription Editor
- The Needs Attention Page
- The Licenses Page
- The Import Page
- The Get Started Page
- When Paddle Can't Be Reached
- 10. The Site Pages
- 11. Settings Reference
- 12. Included Extensions
- I. Scheduled Tasks Reference
- PaddleSubs - Process webhooks — Work through the webhooks Paddle has sent
- PaddleSubs - Access subscription lifecycle — Start and end Access Subscriptions on time
- PaddleSubs - Expiry reminders — Remind customers before and after one-time access ends
- PaddleSubs - Resync user groups — Give every customer the groups their purchases grant
- 13. Emails Reference
- 14. Troubleshooting
- A. How PaddleSubs Handles Each Paddle Event
- B. Licensing API Reference
- C. Developer Reference
- Glossary
- Index