WooCommerce Subscriptions Support

WooGraphQL Pro provides complete GraphQL support for WooCommerce Subscriptions, enabling you to build headless storefronts with full subscription functionality.

• WooCommerce Subscriptions 4.0+
• Subscriptions must be enabled in WooGraphQL Pro settings (woo_subscriptions)

Query and display subscription products with recurring billing information:

• SubscriptionProduct - Simple subscription products
• VariableSubscription - Variable subscription products with pricing variations
• Subscription-specific fields: price, period, interval, length, sign-up fee, trial period

Access and manage customer subscriptions:

• Query individual subscriptions by ID
• List all customer subscriptions with pagination
• Access subscription details: status, dates, billing info, line items
• View related orders and payment history

Full lifecycle management through GraphQL mutations:

• Cancel - Mark subscription as pending cancellation
• Reactivate - Restore cancelled subscriptions
• Switch - Change subscription product with proration
• Update - Modify billing address and details
• Change Payment Method - Update payment method

query GetSubscriptionProduct($id: ID!) {
  product(id: $id, idType: DATABASE_ID) {
    ... on SubscriptionProduct {
      id
      name
      price
      subscriptionPrice
      subscriptionPeriod
      subscriptionPeriodInterval
      subscriptionLength
      subscriptionSignUpFee
      subscriptionTrialLength
      subscriptionTrialPeriod
    }
  }
}

query GetMySubscriptions {
  customer {
    subscriptions(first: 10) {
      nodes {
        id
        databaseId
        status
        billingPeriod
        billingInterval
        startDate
        nextPaymentDate
        endDate
        total
        lineItems {
          nodes {
            product {
              node {
                name
              }
            }
            quantity
          }
        }
      }
    }
  }
}

mutation CancelSubscription($id: Int!) {
  cancelSubscription(input: { id: $id }) {
    subscription {
      id
      status
    }
  }
}

• Querying Subscriptions - Complete query reference
• Subscription Mutations - All subscription mutations
• Subscription Products - Product type reference

• API Types Reference - All subscription-related types
• Mutations Reference - Mutation input/output specifications