Gift Card line_item_id Becomes Read-Only in REST Admin API 2027-01

What Changed

Shopify has announced that the line_item_id property on the Gift Card resource will become read-only starting with REST Admin API version 2027-01. In this version and all subsequent releases, Shopify will ignore any line_item_id value submitted in Gift Card create or update requests.

This means apps will no longer be able to add, replace, or clear a gift card’s association with a line item through the API. The property will still appear in Gift Card responses to reflect existing associations, but it cannot be modified via write operations once version 2027-01 is in effect.

Why This Matters for Developers

Apps that programmatically link gift cards to specific order line items, whether for custom gift card issuance flows, order management integrations, or fulfillment automation, need to review their current implementation. Any existing logic that sets or updates line_item_id during create or update calls will silently fail to produce the intended effect once the app targets API version 2027-01, since Shopify will simply disregard that field without returning an error.

Practical Implications

Developers should audit their codebase for any create or update requests to the Gift Card resource that include line_item_id. These values should be removed from request payloads before upgrading to API version 2027-01.

Since Shopify ignores the field rather than rejecting the request, this change could introduce silent behavioral differences that are easy to miss during testing. Teams maintaining gift card functionality should add this check to their API version migration checklist and verify that any line-item association logic has an alternative implementation path if required for business logic.

Read the full announcement →