Sign up

metadata_update

Learn about the METADATA_UPDATE App Store Server Notification V2. Fired when you change subscription metadata through the Advanced Commerce API.

App Store Server Notifications V2Advanced Commerce
metadata_update

The METADATA_UPDATE notification fires when you change subscription metadata through the Advanced Commerce API Change Subscription Metadata endpoint. It applies only to apps that use Advanced Commerce.


When does it fire?


This notification triggers after a successful metadata change on an Advanced Commerce subscription — for example, updating descriptors or other server-managed subscription fields.


Payload highlights


The notification includes the signed transaction and renewal info for the affected subscription so you can confirm which product and subscriber were updated.


How Yeethook helps


Advanced Commerce changes happen on your server, not in App Store Connect. Yeethook still posts the confirmation to Slack or Discord so support and billing teams see metadata updates next to the rest of the subscription lifecycle.


Common use cases


  • Confirm a metadata change reached Apple
  • Audit Advanced Commerce subscription edits
  • Keep your team's channel aligned with server-driven catalog updates

Example payload

The decoded body after an Advanced Commerce metadata change, sent with no subtype. Note what is absent: there is no diff of the change, only the current signed state of the affected subscription.

{
  "notificationType": "METADATA_UPDATE",
  "notificationUUID": "9b47c05e-31da-4682-a5f7-c0e2913b48d7",
  "version": "2.0",
  "signedDate": 1790926860000,
  "data": {
    "appAppleId": 1234567890,
    "bundleId": "com.example.app",
    "bundleVersion": "142",
    "environment": "Production",
    "signedTransactionInfo": "eyJhbGciOiJFUzI1NiIsIng1YyI6...",
    "signedRenewalInfo": "eyJhbGciOiJFUzI1NiIsIng1YyI6...",
    "status": 1
  }
}

What it looks like in Slack

Info

Subscription metadata updated

Product
com.example.app.pro.monthly
Transaction
2000000798765432
Expires
2026-11-12T09:34:13.000Z
Auto-renew
On
Subscription status
Active
Environment
Production

Questions about metadata_update

Which apps receive METADATA_UPDATE?

Only apps using the Advanced Commerce API, where the subscription catalogue is managed by your server rather than in App Store Connect. Renaming a product in App Store Connect does not fire this or any other notification.

Does the notification tell me what changed?

No. It carries the transaction and renewal info for the affected subscription with no before-and-after values, so identifying the change means comparing against the Change Subscription Metadata request your own server sent.

Can a metadata update affect billing?

No. The expiresDate and auto-renew status are unchanged, which is why the message looks identical to a quiet active subscription. Price edits arrive as PRICE_CHANGE and moves onto Advanced Commerce as MIGRATION.

Learn More

Official Apple documentation:

Get this event in Slack or Discord

Connect Yeethook to receive metadata_update notifications in your team's Slack or Discord channels.

Get Started Free