5/16/2026, 12:01:23 AM
The new previewInstall mutation allows the installation of a storefront preview, returning the installed theme and any user errors. Gift card operations have been updated with richer documentation for credit, debit, send notifications, and update mutations, clarifying scenarios like balance reloading and notification resending. A new isRedeemable boolean on the GiftCard type indicates whether a card can be redeemed in active market currencies. The files query now accepts original_upload_size strings with unit suffixes (B, KB, MB, GB, TB) and supports range filters for easier size queries. giftCardsCount’s description now explicitly covers all gift cards, independent of status, capped at a default maximum of 10,000. Store credit configuration wording now includes the checkout enablement status for clearer context. Publication count fields across many types have been revised to count all publications, including those with feedback errors; new enum values (READY_FOR_RECIPIENT_PICKUP, TOO_MANY_LINES, TOO_MANY_DISCOUNTS) are added. The MarketingEngagement.isCumulative field is now deprecated, urging migration to non‑cumulative metrics.
Retrieves a paginated list of files that have been uploaded to a Shopify store. Files represent digital assets
that merchants can upload to their store for various purposes including product images, marketing materials,
documents, and brand assets.
Use the files query to retrieve information associated with the following workflows:
Files can include multiple content types,
such as images, videos, 3D models, and generic files. Each file has
properties like dimensions, file size, alt text for accessibility, and upload status. Files can be filtered
by media type and can be associated with
products,
themes,
and other store resources.
Returns the total count of gift cards that have been issued by the shop. Use this for dashboard summaries or to understand the scale of a merchant's gift card program. The count includes all gift cards regardless of status (active, disabled, or fully redeemed). Limited to a maximum of 10000 by default.
Returns the store credit configuration for a shop, including whether store credit is enabled for customers at checkout. Use this to display the current state of a merchant's store credit program or check eligibility before issuing store credit to customers.
Installs storefront generation preview for shop.
Adds funds to an existing gift card, increasing its available balance. Use this when a merchant wants to top up a customer's gift card — for example, as a promotional bonus, a customer service gesture, or to reload a reusable gift card.
Removes funds from a gift card, decreasing its available balance. Use this for manual balance adjustments — for example, correcting an accidental over-credit or applying a fee.
Sends a notification to the customer who purchased a gift card, including the gift card details and code. The notification is delivered using the customer's available contact method. Use this to resend the purchase confirmation or remind the purchaser about a gift card they bought.
Sends a notification to the designated recipient of a gift card, delivering the gift card code and redemption instructions. The notification is delivered using the recipient's available contact method. Use this to deliver or re-deliver the gift card to the intended recipient.
Updates the properties of an existing gift card, such as its expiration date, note, or template suffix. Use this to modify gift card details — for example, extending an expiration date for a loyal customer or adding an internal note for tracking purposes.
Return type for previewInstall mutation.
An error that occurs during the execution of PreviewInstall.
Possible error codes that can be returned by PreviewInstallUserError.
publicationCountresourcePublicationsCountREADY_FOR_RECIPIENT_PICKUPREADY_FOR_RECIPIENT_PICKUPisRedeemableWhether the gift card is redeemable in any active market currency.
isCumulativepublicationCountresourcePublicationsCountpublicationCountresourcePublicationsCountpublicationCountresourcePublicationsCountTOO_MANY_LINESTOO_MANY_DISCOUNTS