Local currency support gift cards now available in the GraphQL Admin API

Shopify Adds Local Currency Support for Gift Cards in GraphQL Admin API

Starting in API version 2026-07, the GraphQL Admin API supports local currency gift cards. Developers can now create gift card products that are issued in a specific currency and control whether buyers can redeem those gift cards across different currencies.

What Changed

The update introduces the giftCardProductSet mutation for creating and updating gift card products. This mutation includes new fields for issuanceCurrency and cross-currency redemption controls. Shopify is deprecating the initialValue field in favor of initialAmount for apps that create gift cards directly.

Impact on Shopify App Developers

Apps that handle gift card creation need to migrate from the deprecated initialValue field to initialAmount before API version 2026-07 becomes stable. This change affects any app that programmatically creates or manages gift cards through the Admin API.

The local currency support enables apps to serve merchants operating in multiple markets with different currencies. Apps can now specify which currency a gift card should be issued in and set rules for cross-currency redemption.

Migration Requirements

Developers should review their current gift card implementation if they use the GraphQL Admin API. The transition from initialValue to initialAmount requires code updates to maintain compatibility with future API versions. Apps that don’t handle gift cards directly are not affected by this change.

The new giftCardProductSet mutation provides more granular control over gift card configuration compared to previous API methods.

Read the full announcement →