Skip to main content

​
Overview

The circuly Subscriptions customer portal is an extension that lives inside your customers’ Shopify account page. It gives customers a self-service hub to view, manage, and take actions on their subscriptions — without needing to contact your support team.

​
What customers see

​
Subscription list

When customers visit their account, they see a list of all their subscriptions with key information at a glance:
  • Product name and image
  • Subscription status (Active, Paused, or Cancelled)
  • Billing frequency and pricing
Customers can search subscriptions by product name and filter by status (All, Active, Cancelled, Paused) to quickly find what they’re looking for.

​
Subscription details

Clicking on a subscription opens the detail view, which includes:
  • Next action card — Shows what’s happening next (e.g., next billing date, upcoming delivery)
  • Contract overview — Subscription status, products, pricing, and billing frequency
  • Billing cycles — Upcoming billing schedule with dates and amounts
  • Billing history — Past payments with status (billed, skipped, etc.)
  • Customer information — Name, email, and shipping details
  • Order history — All orders created by this subscription

​
Available customer actions

From the subscription detail view, customers can take several actions depending on their subscription type and your configured policies. Each action is controlled by your settings — you decide what customers can and cannot do.
Customers can temporarily pause their subscription. While paused, no billing occurs. They can resume at any time.
If a subscription is paused, customers can reactivate it to resume billing on the next cycle.
Customers can cancel their subscription, subject to your cancellation policy. For example, you may require a minimum commitment period before cancellation is allowed.If cancellation isn’t available yet, customers see a message explaining when they’ll be able to cancel.
Customers can swap the product in their subscription for a different product or variant. This is useful for changing sizes, colors, or switching to a different item entirely.
For rental subscriptions, customers can purchase the item outright by paying a buyout price. Once the buyout is initiated, they receive an invoice to complete the payment.
For rental subscriptions, customers can initiate a return when their rental period ends.
Customers can update the payment method associated with their subscription directly from the portal.
Each action can be enabled or disabled based on your business rules. If an action is unavailable, customers see it as disabled with an explanation of why.

​
Enabling the customer portal

The customer portal is powered by a Shopify Customer Account UI Extension. It becomes available automatically once the app is installed and your Shopify store uses the new customer accounts.
1

Verify customer accounts are enabled

In your Shopify admin, go to Settings > Customer accounts and make sure customer accounts are enabled (either “classic” or “new” accounts).
2

Check the extension is active

Go to Settings > Customer accounts > Extensions in your Shopify admin. You should see the circuly Subscriptions extension listed and enabled.
3

Test the portal

Log in to your storefront as a customer with an active subscription. Navigate to your account page — you should see the Subscriptions section.

​
Order action menu item

In addition to the full portal, customers also see a “View subscription” action in the order menu when viewing orders that were created by a subscription. Clicking this navigates directly to the subscription detail view in the customer portal.