New Return Reason Definitions API for Better Return Insights
UpdateUnverifiedAdded Sep 24, 2026
You can now use the new ReturnReasonDefinition type to capture more granular, category-specific return reasons when managing returns. This replaces the previous ReturnReason enum with a richer data model that helps provide merchants with better insights in their return analytics, and more tailored return experiences for their buyers.
Topics: SQL, Developer tools
More Shopify developer platform releases
Every Shopify developer platform release| Date | Release | Type |
|---|---|---|
| Jan 1 | Access transactions on the Return objectunverified Update | Update |
| Jan 1 | `INVALID_BILLING_ADDRESS`: new processing error for subscription billing attemptsunverified Pricing | Pricing |
| Jan 1 | Subscription billing attempts throttlingunverified Pricing | Pricing |
| Jan 1 | Introducing the `orders/link_requested` webhook topicunverified Update | Update |
| Jan 1 | Metafield references added to Customer Account APIunverified Update | Update |
| Jan 1 | Due on Fulfillment payment term available for pre-ordersunverified Update | Update |
| Jan 8 | Deprecated `deliveryShippingOriginAssign` mutationunverified Deprecation | Deprecation |
| Dec 22 | Deprecation of `Shop.billingAddress` in favor of `Shop.shopAddress`unverified Deprecation | Deprecation |
Also shipped on Jan 1, 2026
Shopify in January 2026| Date | Company | Release | Product | Type |
|---|---|---|---|---|
| Jan 1 | January 2026 Documentation Changesunverified | Fastly | Update | |
| Jan 1 | Workers - Build microfrontend applications on Workersunverified | Cloudflare developer platform | Update |
Sources: each vendor's own release notes, changelogs and GitHub releases, read daily to monthly by how often it posts. Logos via logo.dev; trademarks belong to their owners.