Starting with the 2025-10 API version, Shopify Functions now support user-defined handles as an alternative identifier in GraphQL mutations. Instead of relying solely on globally unique functionId values, developers can now pass a stable, app-scoped handle defined in their shopify.extension.toml file. All GraphQL mutations that currently accept functionId will now also accept functionHandle, giving developers greater flexibility in managing function owners and configurations.
This change simplifies function management for Shopify app developers by allowing more readable and maintainable identifiers. Rather than tracking opaque function IDs, developers can use intuitive handle names they control directly in their extension configuration. This improvement streamlines the development experience and reduces the friction when creating, updating, or managing Shopify Functions across your app ecosystem.
If your app uses Shopify's GraphQL Admin API to manage functions, GetShopifyToken provides secure OAuth token management to ensure your API calls—whether using functionId or the new functionHandle—are properly authenticated and authorized.