---
title: AppSubscription - GraphQL Admin
description: >-
  A recurring billing agreement that associates an
  [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) with a
  merchant's shop. Each subscription contains one or more
  [`AppSubscriptionLineItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscriptionLineItem)
  objects that define the pricing structure. The pricing structure can include
  recurring charges, usage-based pricing, or both.


  The subscription tracks billing details including the current period end date,
  trial days, and
  [`AppSubscriptionStatus`](https://shopify.dev/docs/api/admin-graphql/latest/enums/AppSubscriptionStatus). 


  Merchants must approve subscriptions through a [confirmation
  URL](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appSubscriptionCreate#returns-confirmationUrl)
  before billing begins. Test subscriptions allow developers to verify billing
  flows without actual charges.


  Learn more about [subscription
  billing](https://shopify.dev/docs/apps/launch/billing/subscription-billing)
  and [testing
  charges](https://shopify.dev/docs/apps/launch/billing/managed-pricing#test-charges).
api_version: 2026-01
api_name: admin
type: object
api_type: graphql
source_url:
  html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscription'
  md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscription.md'
---

# App​Subscription

object

A recurring billing agreement that associates an [`App`](https://shopify.dev/docs/api/admin-graphql/latest/objects/App) with a merchant's shop. Each subscription contains one or more [`AppSubscriptionLineItem`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscriptionLineItem) objects that define the pricing structure. The pricing structure can include recurring charges, usage-based pricing, or both.

The subscription tracks billing details including the current period end date, trial days, and [`AppSubscriptionStatus`](https://shopify.dev/docs/api/admin-graphql/latest/enums/AppSubscriptionStatus).

Merchants must approve subscriptions through a [confirmation URL](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appSubscriptionCreate#returns-confirmationUrl) before billing begins. Test subscriptions allow developers to verify billing flows without actual charges.

Learn more about [subscription billing](https://shopify.dev/docs/apps/launch/billing/subscription-billing) and [testing charges](https://shopify.dev/docs/apps/launch/billing/managed-pricing#test-charges).

## Fields

* createdAt
* currentPeriodEnd
* id
* lineItems
* name
* returnUrl
* status
* test
* trialDays

***

## Map

### Fields and connections with this object

* [AppInstallation.activeSubscriptions](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppInstallation#field-AppInstallation.fields.activeSubscriptions)
* [AppInstallation.allSubscriptions](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppInstallation#field-AppInstallation.fields.allSubscriptions)
* [AppSubscriptionConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/AppSubscriptionConnection#returns-nodes)
* [AppSubscriptionEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppSubscriptionEdge#field-AppSubscriptionEdge.fields.node)

***

## Mutations

* appSubscriptionCancel
* appSubscriptionCreate
* appSubscriptionLineItemUpdate
* appSubscriptionTrialExtend

***

## AppSubscription Mutations

### Mutated by

* [app​Subscription​Cancel](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appSubscriptionCancel)
* [app​Subscription​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appSubscriptionCreate)
* [app​Subscription​Line​Item​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appSubscriptionLineItemUpdate)
* [app​Subscription​Trial​Extend](https://shopify.dev/docs/api/admin-graphql/latest/mutations/appSubscriptionTrialExtend)

***

## Interfaces

* Node

***

## AppSubscription Implements

### Implements

* [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)