--- title: GiftCard - GraphQL Admin description: >- A gift card that customers use as a payment method. Stores the initial value, current balance, and expiration date. You can issue gift cards to a specific [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) or send them to a [`GiftCardRecipient`](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardRecipient) with a personalized message. The card tracks its transaction history through [`GiftCardCreditTransaction`](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardCreditTransaction) and [`GiftCardDebitTransaction`](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardDebitTransaction) records. You can create and deactivate gift cards using the [`GiftCardCreate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardCreate) and [`GiftCardDeactivate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardDeactivate) mutations, respectively. > Note: After a gift card is deactivated, it can't be used for further purchases or re-enabled. api_version: 2025-10 api_name: admin type: object api_type: graphql source_url: html: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCard' md: 'https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCard.md' --- # Gift​Card object Requires `read_gift_cards` access scope. A gift card that customers use as a payment method. Stores the initial value, current balance, and expiration date. You can issue gift cards to a specific [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) or send them to a [`GiftCardRecipient`](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardRecipient) with a personalized message. The card tracks its transaction history through [`GiftCardCreditTransaction`](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardCreditTransaction) and [`GiftCardDebitTransaction`](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardDebitTransaction) records. You can create and deactivate gift cards using the [`GiftCardCreate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardCreate) and [`GiftCardDeactivate`](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardDeactivate) mutations, respectively. *** Note After a gift card is deactivated, it can't be used for further purchases or re-enabled. *** ## Fields * balance [Money​V2!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyV2) non-null The gift card's remaining balance. * created​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) non-null The date and time at which the gift card was created. * customer [Customer](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) The customer who will receive the gift card. * deactivated​At [Date​Time](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) The date and time at which the gift card was deactivated. * enabled [Boolean!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Boolean) non-null Whether the gift card is enabled. * expires​On [Date](https://shopify.dev/docs/api/admin-graphql/latest/scalars/Date) The date at which the gift card will expire. * id [ID!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/ID) non-null A globally-unique ID. * initial​Value [Money​V2!](https://shopify.dev/docs/api/admin-graphql/latest/objects/MoneyV2) non-null The initial value of the gift card. * last​Characters [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The final four characters of the gift card code. * masked​Code [String!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) non-null The gift card code. Everything but the final four characters is masked. * note [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The note associated with the gift card, which isn't visible to the customer. * order [Order](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) The order associated with the gift card. This value is `null` if the gift card was issued manually. * recipient​Attributes [Gift​Card​Recipient](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardRecipient) The recipient who will receive the gift card. * template​Suffix [String](https://shopify.dev/docs/api/admin-graphql/latest/scalars/String) The theme template used to render the gift card online. * transactions [Gift​Card​Transaction​Connection](https://shopify.dev/docs/api/admin-graphql/latest/connections/GiftCardTransactionConnection) The transaction history of the gift card. * updated​At [Date​Time!](https://shopify.dev/docs/api/admin-graphql/latest/scalars/DateTime) non-null The date and time at which the gift card was updated. *** ## Map ### Fields and connections with this object * {}[CustomerMergePreviewDefaultFields.giftCards](https://shopify.dev/docs/api/admin-graphql/latest/objects/CustomerMergePreviewDefaultFields#field-CustomerMergePreviewDefaultFields.fields.giftCards) * <->[GiftCardConnection.nodes](https://shopify.dev/docs/api/admin-graphql/latest/connections/GiftCardConnection#returns-nodes) * {}[GiftCardCreditTransaction.giftCard](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardCreditTransaction#field-GiftCardCreditTransaction.fields.giftCard) * {}[GiftCardDebitTransaction.giftCard](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardDebitTransaction#field-GiftCardDebitTransaction.fields.giftCard) * {}[GiftCardEdge.node](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCardEdge#field-GiftCardEdge.fields.node) * ||-[GiftCardTransaction.giftCard](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/GiftCardTransaction#fields-giftCard) *** ## Queries * [gift​Card](https://shopify.dev/docs/api/admin-graphql/latest/queries/giftCard) query Retrieves a [`GiftCard`](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCard) by its ID. Returns the gift card's balance, transaction history, [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) information, and whether it's enabled. Additional fields include the initial value, expiration date, deactivation timestamp (if applicable), and the associated [`Order`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Order) if the gift card was purchased by a customer through checkout. Gift cards that merchants create manually won't have an associated order. * [gift​Cards](https://shopify.dev/docs/api/admin-graphql/latest/queries/giftCards) query Returns a paginated list of [`GiftCard`](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCard) objects issued for the shop. You can filter gift cards by attributes such as status, last characters of the code, balance status, and other values using the [`query`](https://shopify.dev/docs/api/admin-graphql/latest/queries/giftCards#arguments-query) parameter. You can also apply [`SavedSearch`](https://shopify.dev/docs/api/admin-graphql/latest/objects/SavedSearch) objects to filter results. *** ## \GiftCard Queries ### Queried by * \[gift​Card](https://shopify.dev/docs/api/admin-graphql/latest/queries/giftCard) * \[gift​Cards](https://shopify.dev/docs/api/admin-graphql/latest/queries/giftCards) *** ## Mutations * [gift​Card​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardCreate) mutation Creates a new [`GiftCard`](https://shopify.dev/docs/api/admin-graphql/latest/objects/GiftCard) with a specified initial value. You can assign the gift card to a [`Customer`](https://shopify.dev/docs/api/admin-graphql/latest/objects/Customer) or create it without assignment for manual distribution. You can customize the gift card with an optional code, expiration date, and internal note. If you don't provide a code, the system generates a random 16 character alphanumeric code. The mutation also supports scheduling gift card notifications to recipients, with a personalized message, through the [`recipientAttributes`](https://shopify.dev/docs/api/admin-graphql/latest/input-objects/GiftCardCreateInput#fields-recipientAttributes) field on the `GiftCardCreateInput` input object. * [gift​Card​Deactivate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardDeactivate) mutation Deactivate a gift card. A deactivated gift card cannot be used by a customer. A deactivated gift card cannot be re-enabled. * [gift​Card​Send​Notification​To​Customer](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardSendNotificationToCustomer) mutation Send notification to the customer of a gift card. * [gift​Card​Send​Notification​To​Recipient](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardSendNotificationToRecipient) mutation Send notification to the recipient of a gift card. * [gift​Card​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardUpdate) mutation Update a gift card. *** ## <\~> GiftCard Mutations ### Mutated by * <\~>[gift​Card​Create](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardCreate) * <\~>[gift​Card​Deactivate](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardDeactivate) * <\~>[gift​Card​Send​Notification​To​Customer](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardSendNotificationToCustomer) * <\~>[gift​Card​Send​Notification​To​Recipient](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardSendNotificationToRecipient) * <\~>[gift​Card​Update](https://shopify.dev/docs/api/admin-graphql/latest/mutations/giftCardUpdate) *** ## Interfaces * [Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node) interface *** ## ||-GiftCard Implements ### Implements * ||-[Node](https://shopify.dev/docs/api/admin-graphql/latest/interfaces/Node)