Skip to main content

​
Shopify Subscriptions Reference App

A complete reference implementation for building subscription management applications on the Shopify platform using Remix

​
Overview

The Shopify Subscriptions Reference App is a production-ready example of how to build a subscriptions application with Remix. It includes the core features of the Shopify Subscription app and serves as a starting point for building custom subscription solutions.

Quick Start

Get up and running in minutes with our step-by-step guide

Core Concepts

Learn about subscription contracts, selling plans, and billing cycles

Extensions

Explore the included Shopify UI extensions

API Reference

Dive into the complete API documentation

​
Key Features

Comprehensive lifecycle management for subscription contracts including creation, pause, resume, and cancellation. Customers can manage their subscriptions through a self-service portal.
Create and manage selling plans with customizable discount types (percentage or fixed amount) and delivery frequencies. Support for both prepaid and pay-as-you-go subscription models.
Intelligent billing cycle scheduling with configurable timing and timezone support. Automatic billing attempt retries with dunning management for failed payments.
Multiple UI extensions including customer account management pages, admin subscription actions, POS integration, and theme customizations.
Built-in webhook handlers for all subscription lifecycle events including contract creation, billing attempts, and plan updates.
Complete internationalization with i18next for supporting multiple languages and locales.

​
Technology Stack

The reference app is built with modern web technologies:

​
Use Cases

This reference app is designed for:

Custom Subscription Solutions

Build subscription features tailored to your specific business needs

Learning & Development

Learn best practices for building Shopify apps with subscriptions

Rapid Prototyping

Quickly prototype and test subscription business models

Production Apps

Use as a foundation for production subscription apps (must be substantively different for App Store)

​
App Store Submission

If you’re building an application for the Shopify App Store, your app must be substantively different from this reference application to provide added value for merchants.

​
Getting Help

GitHub Repository

View the source code and report issues

Shopify Dev Docs

Official Shopify subscriptions documentation

Shopify Community

Connect with other Shopify developers

​
Next Steps

Ready to get started? Follow our quickstart guide to create your first subscription app, or dive into the core concepts to understand how subscriptions work on Shopify.

Build docs developers (and LLMs) love

Get started for freeTalk to us