Skip to content

How subscriptions work

Purchase options and subscription contracts explained in plain terms

Use with AI

Use with AI

Ready-made prompts Connect your AI to Pasilobus Install the CLI

This page

View as MarkdownPlain text of this page Open in ClaudeAsk about this page Open in ChatGPTAsk about this page

Ready-made prompts

Fill in the parts in angle brackets, then paste into any assistant.

Step by step on your store

Read https://help.pasilobus.com/subscriptions/how-subscriptions-work.md. Walk me through how subscriptions work in Subscriptions for my store, step by step. My theme is <theme name> and I want <what you want to happen>.

Ask your own question

Read https://help.pasilobus.com/subscriptions/how-subscriptions-work.md. Answer this about Subscriptions on my store: <your question>.

Ask Shopify Sidekick

In your Shopify admin, ask Sidekick about Subscriptions. It searches these guides.

Connect your AI to Pasilobus Beta

Our MCP server lets Claude, ChatGPT, OpenClaw and other MCP clients use your Pasilobus apps. It is in beta and open to every Pasilobus account: you sign in with it when your assistant asks. Tools that change your store are marked as changes, so your assistant asks you first.

https://cloud.pasilobus.com/mcp

In Claude Code, add it, then run /mcp to sign in:

claude mcp add --transport http pasilobus https://cloud.pasilobus.com/mcp

In Claude on the web or desktop, go to Customize › Connectors › Add custom connector and paste the address. In ChatGPT, OpenClaw or another client, add it as a custom connector (MCP) with the same address.

Install the CLI

npm install -g pasilobus

Run your apps from the terminal or a coding agent. These only read, so they are safe to try:

pasilobus subscriptions metrics

Active and paused subscriptions, MRR, churn and upcoming renewals

pasilobus subscriptions prepare_plan

Prepare a new subscription plan as a prefilled form to review and create

pasilobus subscriptions selling_plans

Find subscription plans and their delivery options

pasilobus apps lists your apps on the store; pasilobus <app> help lists what each app can do. How it works

On this page
  1. Purchase options
  2. Subscribing at checkout
  3. The subscription contract
  4. Billing vs. delivery

Subscriptions add a recurring way to buy your products. Instead of a single checkout, a customer agrees to receive a product on a repeating schedule and be charged each time. Understanding two ideas — the purchase option and the subscription contract — makes everything else in the app easier to follow.

Purchase options

A purchase option is the offer a customer subscribes to. It defines how often the product is delivered, any discount, and the rules around it (whether they can pause, how long they're committed, and so on). You attach a purchase option to one or more products, and it shows up on those product pages as a "subscribe" choice.

A single option can offer several frequencies — for example "every month" or "every 2 weeks" — and the customer picks one when they subscribe.

Subscribing at checkout

When a shopper chooses the subscribe option and checks out, two things happen: they pay for the first order, and a recurring agreement is created for future orders. From then on, the app places each renewal order automatically on schedule.

The subscription contract

Once a customer subscribes, their ongoing agreement is called a subscription contract. It holds the products, the frequency, the price, and the next order date. A contract moves through a few states over its life:

  • Active - Orders are being placed on schedule.
  • Paused - Temporarily on hold; nothing is charged until it resumes.
  • Cancelled - Ended by the customer or you; no more orders.
  • Expired - Reached the end of a fixed-length plan and won't renew.

Both you (from your admin) and the customer (from their account) can manage a contract — pausing, skipping a delivery, changing frequency, swapping a product, or cancelling.

Billing vs. delivery

It helps to separate two schedules that are usually the same but don't have to be:

  • Delivery is how often the customer receives the product.
  • Billing is how often they're charged.

For most plans these match (charged monthly, delivered monthly). Some models — like Prepaid — deliberately bill less often than they deliver.

Talk to a person.

The people who build our apps answer support themselves. Send us a message or email us, and a person replies, usually within one business day. There's no chat.