---
title: >-
  The GiftCardConfiguration object now includes default gift card expiration -
  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/giftcardconfiguration-now-includes-default-gift-card-expiration
  md: >-
    https://shopify.dev/changelog/giftcardconfiguration-now-includes-default-gift-card-expiration.md
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: New
    handle: new
  indicatesActionRequired: false
  createdAt: '2026-02-02T13:15:12-05:00'
  postedAt: '2026-02-06T12:00:00-05:00'
  updatedAt: '2026-02-06T09:30:05-05:00'
  effectiveAt: '2026-02-06T12:00:00-05:00'
---

February 6, 2026

Tags:

* Admin GraphQL API
* 2026-04

# The `GiftCardConfiguration` object now includes default gift card expiration

You can now query a merchant's default gift card expiration settings using the GraphQL Admin API.

The new [`expirationConfiguration`](https://shopify.dev/docs/api/admin-graphql/2026-04/objects/GiftCardConfiguration#field-GiftCardConfiguration.fields.expirationConfiguration) field on the [`GiftCardConfiguration`](https://shopify.dev/docs/api/admin-graphql/2026-04/objects/GiftCardConfiguration) object returns the merchant's configured expiration settings, including the duration value and time unit (days, months, or years). When merchants have automatic gift card expiration enabled, you can use these settings to calculate the `expiresOn` date for new gift cards.

## How it works

* The `expirationConfiguration` field returns either:

  * a [`GiftCardExpirationConfiguration`](https://shopify.dev/docs/api/admin-graphql/2026-04/objects/GiftCardExpirationConfiguration) object when the merchant has configured a default gift card expiration
  * `null` when the merchant has gift cards set never to expire

* The `GiftCardExpirationConfiguration` object includes:

  * an [`expirationValue`](https://shopify.dev/docs/api/admin-graphql/2026-04/objects/GiftCardExpirationConfiguration#field-GiftCardExpirationConfiguration.fields.expirationValue) field (integer)
  * an [`expirationUnit`](https://shopify.dev/docs/api/admin-graphql/2026-04/objects/GiftCardExpirationConfiguration#field-GiftCardExpirationConfiguration.fields.expirationUnit) field (enum: `DAYS`, `MONTHS`, `YEARS`)

## Example query

```
query {
  giftCardConfiguration {
    expirationConfiguration {
      expirationValue
      expirationUnit
    }
  }
}
```