Widget & storefront
Do I need the Appstle API to build a custom subscription widget?
Do I need the Appstle API to build a custom subscription widget?
Can I customize the subscription widget appearance?
Can I customize the subscription widget appearance?
- CSS overrides — The widget uses classes prefixed with
appstle_that you can target in your theme CSS. - Merchant portal settings — Configure widget text, labels, and layout options directly in the Appstle admin without writing code.
- JavaScript hooks — Listen to widget events to add custom behavior when the widget loads, when the customer selects a plan, etc.
- Build your own widget — Use Shopify’s native
selling_plan_groupsproduct data to build a completely custom widget.
How does the subscription widget load on my storefront?
How does the subscription widget load on my storefront?
appstle-subscription.js script is automatically injected into your storefront when the app is installed. It:- Reads the product’s
selling_plan_groupsfrom Shopify’s native product JSON - Renders the subscription widget based on your Appstle admin configuration
- Handles selling plan selection and cart integration
- Dispatches JavaScript events you can hook into
Subscriptions & orders
What happens when a customer subscribes?
What happens when a customer subscribes?
- The customer selects a subscription option and adds the product to cart
- At checkout, Shopify creates a subscription contract linked to the selling plan
- Appstle manages the recurring billing cycle, sending billing attempts to Shopify at the configured frequency
- Shopify processes the payment and creates new orders automatically on each cycle
How do I check if a Shopify order is a subscription order?
How do I check if a Shopify order is a subscription order?
sellingPlanAllocation field on each line item.GraphQL query:sellingPlanAllocation is non-null, that line item is a subscription purchase. If it is null, it is a one-time purchase.Subscription line item:selling_plan_allocation on each line item in the Order resource.Can customers manage their own subscriptions?
Can customers manage their own subscriptions?
- View active subscriptions
- Skip upcoming orders
- Pause or resume subscriptions
- Swap products or variants
- Update shipping address
- Change payment method
- Cancel subscriptions (subject to the merchant’s configured rules)
API & integration
How do I authenticate with the Admin API?
How do I authenticate with the Admin API?
X-API-Key header on every request:Do you support webhooks?
Do you support webhooks?
- Subscription created, updated, activated, paused, cancelled
- Billing success, failure, skipped
- Upcoming order notifications
- Billing interval and next order date changes
How do I build an integration for multiple merchants?
How do I build an integration for multiple merchants?
apst_... token for that store — send it as X-API-Key, exactly like a regular API key.If you are building an integration for a single store you own, you only need a regular API key. See Authentication for details.Can I use the Storefront API from a mobile app?
Can I use the Storefront API from a mobile app?
X-API-Key header instead.Data & privacy
Where is my data stored?
Where is my data stored?
- TLS 1.2+ encryption in transit
- AES-256 encryption at rest (AWS KMS)
- VPC isolation and private subnets
- SOC, ISO, and PCI-DSS certified infrastructure
What happens to my data if I uninstall the app?
What happens to my data if I uninstall the app?
app/uninstalled webhook.