---
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
---

[Back to Developer changelog](https://shopify.dev/changelog)

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.