---
title: >-
  New planHandle field for managed pricing app subscription plans - Shopify
  developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: 'https://shopify.dev/changelog/new-planhandle-field-managed-pricing'
  md: 'https://shopify.dev/changelog/new-planhandle-field-managed-pricing.md'
metadata:
  effectiveApiVersion: 2025-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
    - displayName: Webhook
      handle: webhook
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2025-03-10T15:44:29-04:00'
  postedAt: '2025-04-01T13:00:00-04:00'
  updatedAt: '2025-03-17T16:23:20-04:00'
  effectiveAt: '2025-03-29T12:00:00-04:00'
---

April 1, 2025

Tags:

* Admin GraphQL API
* Webhook
* 2025-04

# New `planHandle` field for managed pricing app subscription plans

App subscription plans created with [managed pricing](https://shopify.dev/docs/apps/launch/billing/managed-pricing) now include plan handle data. This makes it easier and more consistent to query for app subscription plans, because these human-readable handles persist even if the plan ID changes due to updates or edits.

`planHandle` is available on the [`AppRecurringPricing`](https://shopify.dev/docs/api/admin-graphql/latest/objects/AppRecurringPricing#field-planhandle) object, while `plan_handle` is included in the [`app_subscriptions/update`](https://shopify.dev/docs/api/webhooks/latest?reference=toml#list-of-topics-app_subscriptions/update) webhook topic.

With this update, you'll now be asked to define your own plan handle when creating new app subscription plans through your Partner Dashboard. All existing plans have been updated with a `planHandle` value based on their plan name.