Developer changelog

New enabled_on/disabled_on attributes replace templates to control section usage in templates and section groups. Use one attribute at a time for precise section placement.

You can now query verifiedByShopifyTier on the MerchantApprovedSignals object to determine what tier of pre-approval a merchant is in if available.

This query helps you to accelerate the...

Developer preview of Functions APIs for delivery and payment customizations lets you hide, reorder, or rename options, enhancing merchant conversions and competitive differentiation.

Merchants can now approve or decline return requests in admin. Partners can automate this via GraphQL Admin API, enhancing return management flexibility.

In Admin GraphQL API 2023-04, publicationId and channelId are validated in publishableUnpublish and productUnpublish mutations. Error message updated for publicationId.

API v2023-04 adds fulfillment_order_line_items parameter to FulfillmentOrder hold/move in GraphQL and REST, allowing selective line item management for stock location adjustments.

GraphQL Admin API 2023-04 introduces support for sorting orders by destination, based on the order's shipping address.

Orders will be sorted first by country, then zone (e.g. state or...

Returns apps now support the stable GraphQL Admin API, enabling automated return management, including creating returns, issuing refunds, and new webhooks for event tracking.

The 2023-01 Admin API update lets you set access for metafield definitions, controlling merchant access in your reserved namespace with PRIVATE, MERCHANT_READ, or MERCHANT_READ_WRITE.

As of 2023-01, tag fulfillment order holds with an external ID to track hold reasons and release timing using the new FulfillmentOrderHoldInput.externalId field.

GraphQL Admin API 2023-01 update enhances delivery settings management with new mutation fields, efficient location queries, and Local Pickup API stability. Documentation updated for performance tips.

Starting January 2023, some API queries may process asynchronously due to complexity. Ensure error handling for async responses. This change supports advanced segmentation filters.

As of Admin API 2023-01, you can subscribe to the new PAYMENT_SCHEDULES_DUE webhook topic to be notified of when a PaymentSchedule.due_at date is reached.

Learn more about the...

As of Admin API version 2023-01, you can use the shopifyqlQuery API to query analytical data from merchant stores to...

As of Admin API 2023-01, Shop Policy now supports the "Contact Information" policy. This policy is intended to allow users to add regulatory information like VAT and Trade number.

The metafieldsSet API now allows MetafieldsSetInput.type to be nullable if definitions exist, simplifying mutations. Type is required if no definitions are present.

From API 2022-07, fulfillment services must use fulfillment orders and set fulfillment_orders_opt_in to true. Errors occur if not set in API 2023-01. Observability added for migration.

As of 2023-01, the Shop.billingAddress field uses a new ShopAddress type instead of the customer-centric MailingAddress type.

Since Shop.billingAddress never returns non-null first...

As of Admin API 2023-01, there are new mutations that allow you to alter the inventory quantities at a location. State quantities reserved and on_hand are adjustable through the API. In addition,...

As of GraphQL Admin API 2023-01, you can load the associated Order or DraftOrder object when querying for a PaymentTerms object.

Until now you could only go from Order or...

As of GraphQL Admin API 2023-01, you can load the associated PaymentTerms object when querying for a PaymentSchedule object.

Until now you could only go from PaymentTerms to...

As of GraphQL Admin API 2023-01, you can use the paymentReminderSend mutation to send payment reminder emails to customers.

Learn more about sending payment reminders on...

The new Admin API lets you create Metaobjects, enabling custom data models with granular access control and publishable entries, enhancing Shopify's data customization capabilities.

As of Shopify Functions API 2023-01, you can use the purchasing company as buyer identity in a B2B context to customize B2B checkout.

As of API version 2023-01, you can create fulfillment events using the GraphQL mutation fulfillmentEventCreate which was previously only accessible via the REST API.

As of 2023-01, the metafieldsSet mutation is atomic and will not persist changes if any errors are encountered.

GraphQL Admin API 2023-01 introduces support for creation of shop resource feedback.

You can now use shopResourceFeedbackCreate mutation to create resource feedback on a shop to let merchant...

As of the 2023-01, you can use the fulfillmentOrdersReleaseHolds mutation to release holds on multiple fulfillment orders in a single request.

This will allow developers to reduce the...

The 2023-01 release adds QueryRoot.fulfillmentOrders, deprecating Shop.fulfillmentOrders. This aligns with the API's focus on domain primitives in QueryRoot.

As of the Admin API 2023-01 release candidate, fulfillment service and order management apps can subscribe to webhooks notifications related to fulfillment orders and events relating to them. ...

As of 2023-01, you can use the EditedAt to see when checkout profile has been edited. Checkout profiles are sorted by EditedAt field instead of updatedAt.UpdatedAt field may be deprecated...

GraphQL Admin API v2023-01 adds productDuplicateAsync and productDeleteAsync mutations for efficient handling of large products with many variants across locations.

You can now use the near parameter to search StoreAvailability by proximity, via Storefront API.

The type is...

As of Jan 2023, Selling Plan Groups' limit increased from 20 to 31. Developers should paginate queries on Selling Plans for better performance.

With GraphQL Storefront API version 2023-01, you can use Metaobject queries to display custom content that's associated with resources like products, customers, and orders. Metaobjects created...

You can now use the Storefront API to filter products by tags if tags are enabled as a filter setting on the shop.

The tag field has been added to the Storefront API's ProductFilter object,...

As of the 2023-01 release candidate in the Admin API, you can use the GraphQL FulfillmentOrderLineItemsPreparedForPickup mutation to mark line items associated with a fulfillment order as...

As of GraphQL Admin API version 2023-01, we are removing the error code INVALID from LocationDeactivateUserError as we never return this error code when using the mutation...

As of 2023-01, Merchants with B2B enabled on their stores can import Orders in a B2B context using the REST API.

Learn more about B2B order imports on...

As of the 2023-01 Admin API release, you can optionally supply the key argument to metafield queries on resources in the format of namespace.key to simplify your queries on the metafield...

As of GraphQL Admin API version 2023-01, metafields are being added to the Company and CompanyLocation primitives for B2B. Additionally, a subset of mutations are now available for use...

As of API version 2023-01, the lineItem field on the FulfillmentOrderLineItem resource has been deprecated. The order line item associated with a FulfillmentOrderLineItem shouldn't be used...

The 2023-01 Admin API update adds payment_details to REST and GraphQL transactions, enhancing credit card info access for developers with fields like expiration, wallet, and AVS codes.

As of Jan 1, 2023, Starter and Basic plans can't request Carrier Service API access. Advanced and Plus plans retain access. Existing access on Starter/Basic plans remains unaffected.

GraphQL Admin API 2023-01 removes SMS Templates as translatable resources, affecting translationsRemove, translationsRegister, translatableResource, and translatableResourcesByIds endpoints.

As of 2023-01 in GraphQL Admin API stable version, you can use shippingPackage as a required argument in shippingPackageUpdate mutation. shippingPackage is a set of attributes that...

As of GraphQL Admin API 2023-01, we are giving apps the capability for Apps to integrate into our Re-engagement marketing automation.

You will now be able to integrate Marketing Automation...

As of today, you can format your code instantly with our Liquid prettier plugin (1.0.0) for consistent code styles so you can avoid discussing styles and focus on what matters. Available both...

Trigger webhook test payloads directly from CLI, reducing dev time. Fewer emails for failed deliveries enhance monitoring by sending one email per consecutive failures over two days.

The Voice and tone section of the App Design Guidelines has been shortened, with a new link to the complete Polaris documentation...