Joy Subscriptions Docs

Everything you need to run subscriptions on your Shopify store with Joy Subscriptions — from creating your first subscribe & save plan to wiring the APIs into a headless storefront.

The documentation is split into two tracks. Pick the one that matches what you are doing.

User Guide

For merchants and support teams working inside the Shopify admin. It covers setting up subscription plans, the storefront widget, the customer portal, emails, discounts, analytics, and the integrations Joy ships with.

• Start here → Welcome — what a subscription business looks like and whether Joy fits your catalogue.
• Quick Start — create your first subscription plan end to end.
• Dashboard — the metrics Joy reports and how to read them.
• Pricing plans — what each plan unlocks.
• FAQs — payment gateways, migration from another app, widget behaviour.

Developer Docs

For developers building against Joy programmatically — a custom customer portal, a headless storefront, or a backend that has to stay in sync with subscription activity.

• Storefront API — a RESTful, JSON-over-HTTPS surface for reading and managing a customer's own subscription contracts.
• API References — endpoint-level reference for the read, management and trial groups, plus shared data types.
• Webhook API — real-time events (subscription created, paused, cancelled, order charged) delivered to your systems.

Need a hand?

Joy is built and supported by Avada (opens in a new tab). If something here does not answer your question, contact support (opens in a new tab) — a human replies. You can also install Joy Subscriptions (opens in a new tab) from the Shopify App Store.