---
title: PendingUpdate - Partner API
description: >-
  Represents pending changes to a subscription that will be applied at the next
  billing cycle.
api_version: 2026-10
source_url:
  html: 'https://shopify.dev/docs/api/partner/latest/objects/PendingUpdate'
  md: 'https://shopify.dev/docs/api/partner/latest/objects/PendingUpdate.md'
api_name: partner
api_type: graphql
type: object
---

# Pending​Update

object

Represents pending changes to a subscription that will be applied at the next billing cycle.

## Fields

* billing​Period

  [App​Pricing​Interval!](https://shopify.dev/docs/api/partner/latest/enums/AppPricingInterval)

  non-null

  The billing period for the pending update.

* items

  [\[Subscription​Item!\]!](https://shopify.dev/docs/api/partner/latest/objects/SubscriptionItem)

  non-null

  The subscription items that will be applied in the next billing cycle.

* legacy​Subscription​Id

  [ID](https://shopify.dev/docs/api/partner/latest/scalars/ID)

  The ID of the legacy AppSubscription object accessible via Admin API.

***

## Map

### Fields with this object

* [ActiveSubscription.pendingUpdate](https://shopify.dev/docs/api/partner/latest/objects/ActiveSubscription#field-ActiveSubscription.fields.pendingUpdate)
* [CancelledSubscription.pendingUpdate](https://shopify.dev/docs/api/partner/latest/objects/CancelledSubscription#field-CancelledSubscription.fields.pendingUpdate)