Developer changelog

The Shopify Functions API for cart and checkout validations is now available in the Checkout Extensibility developer preview.

This API allows you to apply validation rules that run in both the...

Shopify increased Admin API rate limits for Shopify Plus by 10x over standard limits. Apps installed on Shopify Plus stores will now get 500 points/second on the GraphQL Admin API and 20...

The latest GraphQL API update enables using the Catalogs API to customize product offerings and pricing for different customer contexts, linking Shopify Markets and B2B features.

Quickly populate your store with test data in one click, including Shopify Plus features, to accelerate app or theme development with essential commerce primitives and configurations.

Ensure embedded apps load on admin.shopify.com by updating to App Bridge 2.0.5+, implementing the host parameter, and testing on a dev store to avoid redirects and banners.

Effective Feb 6, 2023, updates to the Partner Program Agreement and API License clarify partner responsibilities for resolving violations. Review these changes to ensure compliance.

In Admin REST API 2023-04, total_unsettled_set is added to Transaction responses. Use it for manual capture as it reflects the true remaining amount, including adjustments.

The Predictive Search API now includes a query suggestions resource type, optional Resources[type], performance boosts, and a limit_scope parameter for result management.

We've added intelligent code completion features in Theme Check so that you can speedup writing Liquid code.

You can easily explore Liquid attributes as you type and benefit from type...

Shopify Functions now support the use of variables in input queries, so that you can use merchant input for GraphQL field arguments.

Learn more about input query variables on...

Cart SFAPI now returns a new Cart if the token is invalid. Use the new Cart ID on FailedToRetrieveCart error. Key mutations update or create a new, empty Cart.

Enable merchants to customize store colors with new settings. Define schemes in settings_schema.json, set values in settings_data.json, and use ColorSchemesDrop for CSS access.

As of Admin Graphql API version 2023-04, you can now get inventoryItemId on the FulfillmentOrderLineItem resource.

From January 19th to January 20th, 2023, all private apps will be automatically converted to custom apps managed through the Shopify admin.

Custom apps support all the functionality that private...

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.

Add section groups in theme layouts to organize sections like header/footer. Use JSON containers and Liquid tags for easy management.

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...

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.

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

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

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

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.

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 Shopify Functions API 2023-01, you can use the purchasing company as buyer identity in a B2B context to customize B2B checkout.

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 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...

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 load the associated Order or DraftOrder object when querying for a PaymentTerms object.

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

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 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...

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.

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 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 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...

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...