Add email DNS status, item taxonomy, return tax adjustments

9/17/2026, 12:01:07 AM

A new enum EmailSenderConfigurationDnsRecordStatus describes the outcome of DNS checks for an email sender domain.
The EmailSenderConfigurationDnsRecord type now includes a stable handle string and the status enum, enabling clients to monitor DNS health.
Both DraftOrderLineItem and CalculatedDraftOrderLineItem received a new productCategory field that references Shopify’s Standard Product Taxonomy, informing tax treatment of custom line items.
CalculatedReturnShippingFee.taxAmountSet was changed to indicate an estimated tax amount, clarifying that it may differ from the final value.
ReturnShippingFee.finalizedTaxAmountSet was updated to explain that it can differ from the estimate and will be zero if no tax applies.
These changes give developers tighter control over email delivery status tracking, product categorization for taxes, and clearer return tax data.

Type Changes

βž• Added Types (1)

πŸ“‹EmailSenderConfigurationDnsRecordStatusβž• AddedENUM

The result of the last check of a DNS record against the DNS zone of the sender domain.

Values: VALID, MISSING, MISMATCH, UNKNOWN

πŸ”„ Modified Types (5)

πŸ—οΈCalculatedDraftOrderLineItemπŸ”„ Modified
βž• Field added: productCategory

The category of a custom line item from Shopify's Standard Product Taxonomy.
Used to determine the item's tax treatment.

πŸ—οΈCalculatedReturnShippingFeeπŸ”„ Modified
πŸ”„ Field modified: taxAmountSet
πŸ—οΈDraftOrderLineItemπŸ”„ Modified
βž• Field added: productCategory

The category of a custom line item from Shopify's Standard Product Taxonomy.
Used to determine the item's tax treatment.

πŸ—οΈEmailSenderConfigurationDnsRecordπŸ”„ Modified
βž• Field added: handle

The stable identifier of the DNS record. It doesn't change when the merchant changes the sender domain.

βž• Field added: status

The result of the last check of this record against the DNS zone of the sender domain.

πŸ—οΈReturnShippingFeeπŸ”„ Modified
πŸ”„ Field modified: finalizedTaxAmountSet