---
title: >-
  Local currency support gift cards now available in the GraphQL Admin API -
  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/gift-card-local-currency-support'
  md: 'https://shopify.dev/changelog/gift-card-local-currency-support.md'
metadata:
  effectiveApiVersion: 2026-07
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2026-05-22T05:56:37-04:00'
  postedAt: '2026-06-05T12:00:00-04:00'
  updatedAt: '2026-06-05T17:20:18-04:00'
  effectiveAt: '2026-05-27T12:00:00-04:00'
---

June 5, 2026

Tags:

* Admin GraphQL API
* 2026-07

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

Starting in API version `2026-07`, the GraphQL Admin API supports local currency gift cards. You can create gift card products that are issued in a specific currency, and control whether buyers can redeem those gift cards across currencies. If your app creates gift cards directly, migrate from the deprecated `initialValue` field to `initialAmount`.

## What changed

Use the new [`giftCardProductSet`](https://shopify.dev/docs/api/admin-graphql/2026-07/mutations/giftCardProductSet) mutation to create and update gift card products. The input includes [`issuanceCurrency`](https://shopify.dev/docs/api/admin-graphql/2026-07/input-objects/GiftCardProductSetInput#field-GiftCardProductSetInput.fields.issuanceCurrency) and [`crossCurrencyRedeemable`](https://shopify.dev/docs/api/admin-graphql/2026-07/input-objects/GiftCardProductSetInput#field-GiftCardProductSetInput.fields.crossCurrencyRedeemable), and automatically applies the product’s gift card settings to its variants. You can set `issuanceCurrency` and `crossCurrencyRedeemable` only when you create the product; you can’t change either field afterward.

Inspect a product’s settings through [`Product.giftCardSettings`](https://shopify.dev/docs/api/admin-graphql/2026-07/objects/Product#field-Product.fields.giftCardSettings). If [`issuanceCurrency`](https://shopify.dev/docs/api/admin-graphql/2026-07/objects/GiftCardProductSettings#field-GiftCardProductSettings.fields.issuanceCurrency) is `null`, Shopify issues gift cards from the product in the shop’s currency. If `issuanceCurrency` is set, Shopify issues gift cards in the specified currency, and buyers can purchase the product only in that currency. Publish these products only in markets where that currency is supported.

[`crossCurrencyRedeemable`](https://shopify.dev/docs/api/admin-graphql/2026-07/objects/GiftCardProductSettings#field-GiftCardProductSettings.fields.crossCurrencyRedeemable) controls redemption behavior across currencies:

* If `crossCurrencyRedeemable` is `false`, issued gift cards use a `crossCurrencyRedemptionStrategy` of [`NONE`](https://shopify.dev/docs/api/admin-graphql/2026-07/enums/GiftCardCrossCurrencyRedemptionStrategy#enums-NONE).
* If `crossCurrencyRedeemable` is `true` and the product has no issuance currency, gift cards use [`MARKET_FX`](https://shopify.dev/docs/api/admin-graphql/2026-07/enums/GiftCardCrossCurrencyRedemptionStrategy#enums-MARKET_FX).
* If `crossCurrencyRedeemable` is `true` and the product has an issuance currency, gift cards use [`SPOT_FX`](https://shopify.dev/docs/api/admin-graphql/2026-07/enums/GiftCardCrossCurrencyRedemptionStrategy#enums-SPOT_FX).

Gift card creation now accepts [`initialAmount`](https://shopify.dev/docs/api/admin-graphql/2026-07/input-objects/GiftCardCreateInput#field-GiftCardCreateInput.fields.initialAmount), which replaces the deprecated `initialValue` field. `initialAmount` includes both the amount and currency. Query [`GiftCard.isRedeemable`](https://shopify.dev/docs/api/admin-graphql/2026-07/objects/GiftCard#field-GiftCard.fields.isRedeemable) and [`GiftCard.crossCurrencyRedemptionStrategy`](https://shopify.dev/docs/api/admin-graphql/2026-07/objects/GiftCard#field-GiftCard.fields.crossCurrencyRedemptionStrategy) to check whether a gift card can be redeemed and how cross-currency conversion is handled.

## What to do

1. If you create gift cards using `giftCardCreate`, replace `initialValue` with `initialAmount` before you upgrade to `2026-07`.
2. If you offer multi-currency stores, decide whether new gift card products should be pinned to a single issuance currency. Configure `issuanceCurrency` and `crossCurrencyRedeemable` when you create the product; you can’t change either field afterward.
3. Update redemption flows to read `GiftCard.crossCurrencyRedemptionStrategy` so you can surface accurate cross-currency conversion behavior to merchants and buyers.

## Related docs

* [`giftCardProductSet` mutation](https://shopify.dev/docs/api/admin-graphql/2026-07/mutations/giftCardProductSet)
* [`GiftCard` object](https://shopify.dev/docs/api/admin-graphql/2026-07/objects/GiftCard)
* [`Product.giftCardSettings`](https://shopify.dev/docs/api/admin-graphql/2026-07/objects/Product#field-Product.fields.giftCardSettings)
* [`GiftCardCrossCurrencyRedemptionStrategy` enum](https://shopify.dev/docs/api/admin-graphql/2026-07/enums/GiftCardCrossCurrencyRedemptionStrategy)