> Note:
> We're no longer publishing API release notes. Instead, you can find the latest updates on Shopify APIs in our [developer changelog](https://shopify.dev/changelog). You can filter updates by area. For example, you can filter API updates by the API name and version, such as GraphQL Admin API changes in version 2025-04.


<table>
  <tr>
    <th>Release date</th>
    <th>Date version is no longer supported</th>
  </tr>
  <tr>
    <td>January 1, 2020</td>
    <td>January 1, 2021</td>
  </tr>
</table>

The 2020-01 release contains many of the features we previewed at [Unite 2019](https://www.shopify.ca/partners/blog/shopify-unite-announcements-2019). The product media, order editing, and fulfillment orders features are now stable and available on merchant stores. You’ll also find new additions to how you can manage smart collections and discount codes.

**What's new in 2020-01**

The following features were added in version 2020-01 of Shopify’s APIs:

* [Manage the various types of media associated with merchants' products](/docs/apps/build/online-store/product-media) using the GraphQL Admin API.
* [Edit orders](/docs/apps/build/orders-fulfillment/order-management-apps/edit-orders) using the GraphQL Admin API.
* [Improve your fulfillment workflows with fulfillment orders](/docs/apps/build/orders-fulfillment/fulfillment-service-apps) using the GraphQL Admin API.
* [Manage smart collections more effectively](/docs/api/admin-rest/latest/resources/collection) using the REST Admin API.
* [Create “Spend X Get Y” discount codes](/docs/apps/build/discounts#related-mutations-and-queries) using the GraphQL Admin API.

## Breaking changes
These changes require special attention. If your app uses these API resources, and you don’t adjust your usage of the resources according to the following instructions, then your app might break when you update to this API version.


### Collects API

As of verison 2020-01, the Collects REST API only returns collects associated with custom collections, and no longer returns products associated with Smart Collections. To get the products in a smart collection, use the new `/admin/api/2020-04/collections/#{collection_id}/products.json` endpoint.

### Maximum input array size for GraphQL operations

Input arguments that accept an array now have a maximum size of 250. Queries and mutations return an error if an input array exceeds 250 items. This change applies to both the Admin API and the Storefront API.

## REST Admin API changes

Below are all the changes introduced in the 2020-01 version of the REST Admin API.

<div class="accordion-container">
  <div class="accordion-controls">
    <button class="accordion-control" data-accordion-control-type="expand-all" type="button">Expand all</button>
  </div>
  <div class="accordion-content-container">
    <div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Collects <span class="heading-flag breaking"></span></h3>
  </div>
  <div class="accordion-content">
    <p>Collects API now returns only collects associated with custom collections, and no longer returns products associated with Smart Collections. The following endpoints are affected:</p>
<ul>
<li><code class="text-highlight text-highlight--grey">GET /admin/api/2020-01/collects.json</code>: Now only returns collects associated with custom collections.</li>
<li><code class="text-highlight text-highlight--grey">GET /admin/api/2020-01/collects/count.json</code>: Now only returns the count of collects associated with custom collections.</li>
<li><code class="text-highlight text-highlight--grey">GET /admin/api/2020-01/collects/{collect_id}.json</code>: If the ID <code class="text-highlight text-highlight--grey">collect_id</code> is related to smart collection, then this endpoint returns a 404 error.</li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>New Collections API</h3>
  </div>
  <div class="accordion-content">
    <ul>
<li>New API for getting products inside a collection. <code class="text-highlight text-highlight--grey">GET /admin/api/2020-01/collections/#{collection_id}/products.json</code></li>
<li>New API for getting a collection by its ID. <code class="text-highlight text-highlight--grey">GET /admin/api/2020-01/collections/#{collection_id}.json</code></li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Fulfillment orders</h3>
  </div>
  <div class="accordion-content">
    <p>You can manage fulfillments with more control using FulfillmentOrder-based fulfillment. To learn more, refer to <a href="/docs/apps/build/orders-fulfillment/fulfillment-service-apps">Managing fulfillments with the FulfillmentOrder resource</a>.</p>
<div class="heading-wrapper heading-wrapper-3"><h3 id="fulfillment-services">Fulfillment Services</h3><a class="article-anchor-link" href="#fulfillment-services"><span class="visuallyhidden">Anchor link to section titled "Fulfillment Services"</span></a></div>
<ul>
<li>Added the <code class="text-highlight text-highlight--grey">fulfillment_orders_opt_in</code> property to fulfillment services.</li>
</ul>
<div class="heading-wrapper heading-wrapper-3"><h3 id="assigned-fulfillment-orders">Assigned fulfillment orders</h3><a class="article-anchor-link" href="#assigned-fulfillment-orders"><span class="visuallyhidden">Anchor link to section titled "Assigned fulfillment orders"</span></a></div>
<ul>
<li>Added a new route <code class="text-highlight text-highlight--grey">GET /admin/api/2020-01/assigned_fulfillment_orders.json?assignment_status=cancellation_requested&amp;location_ids[]=487838322</code> to retrieve all the fulfillment orders that are assigned to an app at the shop level.</li>
</ul>
<div class="heading-wrapper heading-wrapper-3"><h3 id="cancellation-requests">Cancellation requests</h3><a class="article-anchor-link" href="#cancellation-requests"><span class="visuallyhidden">Anchor link to section titled "Cancellation requests"</span></a></div>
<ul>
<li>Added a new route <code class="text-highlight text-highlight--grey">POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/cancellation_request.json</code> to send a cancellation request to a fulfillment service for a fulfillment order.</li>
<li>Added a new route <code class="text-highlight text-highlight--grey">POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/cancellation_request/accept.json</code> to accept a cancellation request sent to a fulfillment service for a fulfillment order.</li>
<li>Added a new route <code class="text-highlight text-highlight--grey">POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/cancellation_request/reject.json</code> to reject a cancellation request sent to a fulfillment service for a fulfillment order.</li>
</ul>
<div class="heading-wrapper heading-wrapper-3"><h3 id="fulfillment-requests">Fulfillment requests</h3><a class="article-anchor-link" href="#fulfillment-requests"><span class="visuallyhidden">Anchor link to section titled "Fulfillment requests"</span></a></div>
<ul>
<li>Added a new route <code class="text-highlight text-highlight--grey">POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/fulfillment_request.json</code> to send a fulfillment request to a fulfillment service for a fulfillment order.</li>
<li>Added a new route <code class="text-highlight text-highlight--grey">POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/fulfillment_request/accept.json</code> to accept a fulfillment request to a fulfillment service for a fulfillment order.</li>
<li>Added a new route <code class="text-highlight text-highlight--grey">POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/fulfillment_request/reject.json</code> to reject a fulfillment request to a fulfillment service for a fulfillment order.</li>
</ul>
<div class="heading-wrapper heading-wrapper-3"><h3 id="fulfillment-orders">Fulfillment orders</h3><a class="article-anchor-link" href="#fulfillment-orders"><span class="visuallyhidden">Anchor link to section titled "Fulfillment orders"</span></a></div>
<ul>
<li>Added a new route <code class="text-highlight text-highlight--grey">GET /admin/api/2020-01/orders/#{order_id}/fulfillment_orders.json</code> to retrieve a list of fulfillment orders for a specific order.</li>
<li>Added a new route <code class="text-highlight text-highlight--grey">GET /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}.json</code> to retrieve a specific fulfillment order.</li>
<li>Added a new route <code class="text-highlight text-highlight--grey">POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/cancel.json</code> to cancel a fulfillment order.</li>
<li>Added a new route <code class="text-highlight text-highlight--grey">POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/close.json</code> to close a fulfillment order.</li>
<li>Added a new route <code class="text-highlight text-highlight--grey">POST /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/move.json</code> to move a fulfillment order.</li>
</ul>
<div class="heading-wrapper heading-wrapper-3"><h3 id="locations-for-move">Locations for move</h3><a class="article-anchor-link" href="#locations-for-move"><span class="visuallyhidden">Anchor link to section titled "Locations for move"</span></a></div>
<ul>
<li>Added a new route <code class="text-highlight text-highlight--grey">GET /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/locations_for_move.json</code> to retrieve locations that a fulfillment order can potentially move to.</li>
</ul>
<div class="heading-wrapper heading-wrapper-3"><h3 id="fulfillments">Fulfillments</h3><a class="article-anchor-link" href="#fulfillments"><span class="visuallyhidden">Anchor link to section titled "Fulfillments"</span></a></div>
<ul>
<li>Added a new route <code class="text-highlight text-highlight--grey">GET /admin/api/2020-01/fulfillment_orders/#{fulfillment_order_id}/fulfillments.json</code> to retrieve fulfillments associated with a fulfillment order.</li>
<li>Added a new route <code class="text-highlight text-highlight--grey">POST /admin/api/2020-01/fulfillments.json</code> to create a fulfillment for one or many fulfillment orders.</li>
<li>Added a new route <code class="text-highlight text-highlight--grey">POST /admin/api/2020-01/fulfillments/#{fulfillment_id}/cancel.json</code> to cancel a fulfillment.</li>
<li>Added a new route <code class="text-highlight text-highlight--grey">POST /admin/api/2020-01/fulfillments/#{fulfillment_id}/update_tracking.json</code> to update the tracking information for a fulfillment.</li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Changes to webhooks</h3>
  </div>
  <div class="accordion-content">
    <p>The following changes have been made to the <a href="/docs/api/admin-rest/latest/resources/webhook">Webhook</a> resource:</p>
<p><strong>New topics</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">orders/edited</code> was added as part of the new <a href="#graphql-admin-api-changes">order editing feature for the GraphQL Admin API</a>.</li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Track whether inventory items need shipping</h3>
  </div>
  <div class="accordion-content">
    <ul>
<li>The <code class="text-highlight text-highlight--grey">requires_shipping</code> property on the <a href="/docs/api/admin-rest/latest/resources/inventoryitem">InventoryItem</a> resource can now be updated. This property replaces the deprecated <code class="text-highlight text-highlight--grey">requires_shipping</code> property on the <a href="/docs/api/admin-rest/latest/resources/product-variant">Product Variant</a> resource.</li>
</ul>
  </div>
</div>
  </div>
</div>


## GraphQL Admin API changes

Below are all the changes introduced in the 2020-01 version of the GraphQL Admin API.

<div class="accordion-container">
  <div class="accordion-controls">
    <button class="accordion-control" data-accordion-control-type="expand-all" type="button">Expand all</button>
  </div>
  <div class="accordion-content-container">
    <div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Maximum input array size for GraphQL operations <span id="maximum-input-size-admin-api" class="heading-flag breaking"></span></h3>
  </div>
  <div class="accordion-content">
    <p>Input arguments that accept an array have a maximum size of 250. Queries and mutations return an error if an input array exceeds 250 items.</p>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Associate new media types with products</h3>
  </div>
  <div class="accordion-content">
    <p>Products now support three types of media: images, 3D models, and videos. Use the GraphQL Admin API to upload media assets and then associate them with a product. To learn more, refer to <a href="/docs/apps/build/online-store/product-media">Working with product media</a>.</p>
<p><strong>Updated types</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">VIDEO</code> value was added to enum <a href="/docs/api/admin-graphql/latest/enums/stageduploadtargetgenerateuploadresource"><code class="text-highlight text-highlight--grey">StagedUploadTargetGenerateUploadResource</code></a></li>
<li><code class="text-highlight text-highlight--grey">MODEL_3D</code> value was added to enum <a href="/docs/api/admin-graphql/latest/enums/stageduploadtargetgenerateuploadresource"><code class="text-highlight text-highlight--grey">StagedUploadTargetGenerateUploadResource</code></a></li>
<li><code class="text-highlight text-highlight--grey">IMAGE</code> value was added to enum <a href="/docs/api/admin-graphql/latest/enums/stageduploadtargetgenerateuploadresource"><code class="text-highlight text-highlight--grey">StagedUploadTargetGenerateUploadResource</code></a></li>
<li><code class="text-highlight text-highlight--grey">media: [CreateMediaInput!]</code> argument was added to mutation <a href="/docs/api/admin-graphql/latest/mutations/productcreate"><code class="text-highlight text-highlight--grey">productCreate</code></a></li>
</ul>
<p><strong>New fields</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">fileSize</code> field was added to input object type <a href="/docs/api/admin-graphql/latest/input-objects/stageduploadtargetgenerateinput"><code class="text-highlight text-highlight--grey">StagedUploadTargetGenerateInput</code></a></li>
<li><code class="text-highlight text-highlight--grey">mediaCount</code> field was added to object type <a href="/docs/api/admin-graphql/latest/objects/product"><code class="text-highlight text-highlight--grey">Product</code></a></li>
<li><code class="text-highlight text-highlight--grey">media</code> field was added to object type <a href="/docs/api/admin-graphql/latest/objects/product"><code class="text-highlight text-highlight--grey">Product</code></a></li>
<li><code class="text-highlight text-highlight--grey">featuredMedia</code> field was added to object type <a href="/docs/api/admin-graphql/latest/objects/product"><code class="text-highlight text-highlight--grey">Product</code></a></li>
</ul>
<p><strong>New types</strong></p>
<ul>
<li><a href="/docs/api/admin-graphql/latest/objects/videosource"><code class="text-highlight text-highlight--grey">VideoSource</code></a> object was added</li>
<li><a href="/docs/api/admin-graphql/latest/objects/video"><code class="text-highlight text-highlight--grey">Video</code></a> object was added</li>
<li><a href="/docs/api/admin-graphql/latest/objects/model3dsource"><code class="text-highlight text-highlight--grey">Model3dSource</code></a> object was added</li>
<li><a href="/docs/api/admin-graphql/latest/objects/model3d"><code class="text-highlight text-highlight--grey">Model3d</code></a> object was added</li>
<li><a href="/docs/api/admin-graphql/latest/objects/mediaimage"><code class="text-highlight text-highlight--grey">MediaImage</code></a> object was added</li>
<li><a href="/docs/api/admin-graphql/latest/objects/externalvideo"><code class="text-highlight text-highlight--grey">ExternalVideo</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/input-objects/stageduploadinput"><code class="text-highlight text-highlight--grey">StagedUploadInput</code></a> input object was added</li>
<li><a href="/docs/api/admin-graphql/latest/objects/stageduploadparameter"><code class="text-highlight text-highlight--grey">StagedUploadParameter</code></a> object was added</li>
<li><a href="/docs/api/admin-graphql/latest/objects/stagedmediauploadtarget"><code class="text-highlight text-highlight--grey">StagedMediaUploadTarget</code></a> object was added</li>
<li><a href="/docs/api/admin-graphql/latest/input-objects/updatemediainput"><code class="text-highlight text-highlight--grey">UpdateMediaInput</code></a> input object was added</li>
<li><a href="/docs/api/admin-graphql/latest/input-objects/createmediainput"><code class="text-highlight text-highlight--grey">CreateMediaInput</code></a> input object was added</li>
<li><a href="/docs/api/admin-graphql/latest/enums/productmediasortkeys"><code class="text-highlight text-highlight--grey">ProductMediaSortKeys</code></a> enum was added</li>
<li><a href="/docs/api/admin-graphql/latest/enums/mediastatus"><code class="text-highlight text-highlight--grey">MediaStatus</code></a> enum was added</li>
<li><a href="/docs/api/admin-graphql/latest/enums/productmediasortkeys"><code class="text-highlight text-highlight--grey">MediaPreviewImageStatus</code></a> enum was added</li>
<li><a href="/docs/api/admin-graphql/latest/enums/productmediasortkeys"><code class="text-highlight text-highlight--grey">MediaPreviewImage</code></a> enum was added</li>
<li><a href="/docs/api/admin-graphql/latest/enums/mediaerrorcode"><code class="text-highlight text-highlight--grey">MediaErrorCode</code></a> enum was added</li>
<li><a href="/docs/api/admin-graphql/latest/objects/mediaerror"><code class="text-highlight text-highlight--grey">MediaError</code></a> object was added</li>
<li><a href="/docs/api/admin-graphql/latest/enums/mediacontenttype"><code class="text-highlight text-highlight--grey">MediaContentType</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/interfaces/media"><code class="text-highlight text-highlight--grey">Media</code></a> interface was added</li>
</ul>
<p><strong>New mutations</strong></p>
<ul>
<li><a href="/docs/api/admin-graphql/latest/mutations/stageduploadscreate"><code class="text-highlight text-highlight--grey">stagedUploadsCreate</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/productupdatemedia"><code class="text-highlight text-highlight--grey">productUpdateMedia</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/productreordermedia"><code class="text-highlight text-highlight--grey">productReorderMedia</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/productdeletemedia"><code class="text-highlight text-highlight--grey">productDeleteMedia</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/productcreatemedia"><code class="text-highlight text-highlight--grey">productCreateMedia</code></a> was added</li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Edit existing orders</h3>
  </div>
  <div class="accordion-content">
    <p>You can now edit orders to add items, remove items, or update item quantities. To learn more, refer to <a href="/docs/apps/build/orders-fulfillment/order-management-apps/edit-orders">Editing existing orders</a>.</p>
<p><strong>Updated types</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">EDIT_ORDERS</code> was added to enum type <code class="text-highlight text-highlight--grey">StaffMemberPermission</code></li>
</ul>
<p><strong>New types</strong></p>
<ul>
<li><a href="/docs/api/admin-graphql/latest/mutations/calculatedorder"><code class="text-highlight text-highlight--grey">CalculatedOrder</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/orderstagedchangeincrementitem"><code class="text-highlight text-highlight--grey">OrderStagedChangeIncrementItem</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/orderstagedchangedecrementitem"><code class="text-highlight text-highlight--grey">OrderStagedChangeDecrementItem</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/orderstagedchangeaddvariant"><code class="text-highlight text-highlight--grey">OrderStagedChangeAddVariant</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/orderstagedchangeaddcustomitem"><code class="text-highlight text-highlight--grey">OrderStagedChangeAddCustomItem</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/orderstagedchange"><code class="text-highlight text-highlight--grey">OrderStagedChange</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/calculatedlineitem"><code class="text-highlight text-highlight--grey">CalculatedLineItem</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/lineitemmutable"><code class="text-highlight text-highlight--grey">LineItemMutable</code></a> was added</li>
</ul>
<p><strong>New fields</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">totalOutstandingSet</code> was added to <a href="/docs/api/admin-graphql/latest/objects/order"><code class="text-highlight text-highlight--grey">Order</code></a></li>
<li><code class="text-highlight text-highlight--grey">refundDiscrepancySet</code> was added to <a href="/docs/api/admin-graphql/latest/objects/order"><code class="text-highlight text-highlight--grey">Order</code></a></li>
<li><code class="text-highlight text-highlight--grey">originalTotalPriceSet</code> was added to <a href="/docs/api/admin-graphql/latest/objects/order"><code class="text-highlight text-highlight--grey">Order</code></a></li>
<li><code class="text-highlight text-highlight--grey">lineItemsMutable</code> was added to <a href="/docs/api/admin-graphql/latest/objects/order"><code class="text-highlight text-highlight--grey">Order</code></a></li>
<li><code class="text-highlight text-highlight--grey">edited</code> was added to <a href="/docs/api/admin-graphql/latest/objects/order"><code class="text-highlight text-highlight--grey">Order</code></a></li>
</ul>
<p><strong>New mutations</strong></p>
<ul>
<li><a href="/docs/api/admin-graphql/latest/mutations/ordereditsetquantity"><code class="text-highlight text-highlight--grey">orderEditSetQuantity</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/ordereditcommit"><code class="text-highlight text-highlight--grey">orderEditCommit</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/ordereditbegin"><code class="text-highlight text-highlight--grey">orderEditBegin</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/ordereditaddvariant"><code class="text-highlight text-highlight--grey">orderEditAddVariant</code></a> was added</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/ordereditaddcustomitem"><code class="text-highlight text-highlight--grey">orderEditAddCustomItem</code></a> was added</li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Grant staff members permission to edit translated content</h3>
  </div>
  <div class="accordion-content">
    <p>Staff member permissions include the option to edit translated content.</p>
<p><strong>Updated types</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">TRANSLATIONS</code> was added to enum <code class="text-highlight text-highlight--grey">StaffMemberPermission</code></li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Manage fulfillments with fulfillment orders</h3>
  </div>
  <div class="accordion-content">
    <p>You can manage fulfillments with more control using FulfillmentOrder-based fulfillment. To learn more, refer to <a href="/docs/apps/build/orders-fulfillment/fulfillment-service-apps">Managing fulfillments with the FulfillmentOrder resource</a>.</p>
<p><strong>Updated types</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">IN_PROGRESS</code> value was added to the <a href="/docs/api/admin-graphql/latest/enums/orderdisplayfulfillmentstatus">OrderDisplayFulfillmentStatus</a> enum.</li>
</ul>
<p><strong>New fields</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">fulfillment_order</code> was added to <a href="/docs/api/admin-graphql/latest/objects/queryroot">QueryRoot</a>.</li>
<li><code class="text-highlight text-highlight--grey">fulfillment_orders</code> was added to <a href="/docs/api/admin-graphql/latest/objects/shop">Shop</a>.</li>
<li><code class="text-highlight text-highlight--grey">assigned_fulfillment_orders</code> was added to <a href="/docs/api/admin-graphql/latest/objects/shop">Shop</a>.</li>
<li><code class="text-highlight text-highlight--grey">fulfillment_orders</code> was added to <a href="/docs/api/admin-graphql/latest/objects/order">Order</a>.</li>
<li><code class="text-highlight text-highlight--grey">fulfillment_orders</code> was added to <a href="/docs/api/admin-graphql/latest/objects/fulfillment">Fulfillment</a>.</li>
<li><code class="text-highlight text-highlight--grey">order</code> was added to <a href="/docs/api/admin-graphql/latest/objects/fulfillment">Fulfillment</a>.</li>
<li><code class="text-highlight text-highlight--grey">callback_url</code> was added to <a href="/docs/api/admin-graphql/latest/objects/fulfillmentservice">FulfillmentService</a>.</li>
<li><code class="text-highlight text-highlight--grey">fulfillment_orders_opt_in</code> was added to <a href="/docs/api/admin-graphql/latest/objects/fulfillmentservice">FulfillmentService</a>.</li>
</ul>
<p><strong>New types</strong></p>
<ul>
<li><a href="/docs/api/admin-graphql/latest/input-objects/fulfillmenttrackinginput">FulfillmentTrackingInput</a> input type was added.</li>
<li><a href="/docs/api/admin-graphql/latest/input-objects/fulfillmentv2input">FulfillmentV2Input</a> input type was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentorder">FulfillmentOrder</a> object was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentorderaction">FulfillmentOrderAction</a> enum was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentorderassignedlocation">FulfillmentOrderAssignedLocation</a> object was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentorderassignmentstatus">FulfillmentOrderAssignmentStatus</a> enum was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentorderdestination">FulfillmentOrderDestination</a> object was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentorderlineitem">FulfillmentOrderLineItem</a> object was added.</li>
<li><a href="/docs/api/admin-graphql/latest/input-objects/fulfillmentorderlineiteminput">FulfillmentOrderLineItemInput</a> input type was added.</li>
<li><a href="/docs/api/admin-graphql/latest/input-objects/fulfillmentorderlineitemsinput">FulfillmentOrderLineItemsInput</a> input type was added.</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/fulfillmentorderlocationformove">FulfillmentOrderLocationForMove</a> object was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentordermerchantrequest">FulfillmentOrderMerchantRequest</a> object was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentordermerchantrequestkind">FulfillmentOrderMerchantRequestKind</a> enum was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentorderrequeststatus">FulfillmentOrderRequestStatus</a> enum was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentordersupportedaction">FulfillmentOrderSupportedAction</a> object was added.</li>
</ul>
<p><strong>New mutations</strong></p>
<ul>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentcreatev2">FulfillmentCreateV2</a> was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmenttrackinginfoupdatev2">FulfillmentTrackingInfoUpdateV2</a> was added.</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/fulfillmentcancel">fulfillmentCancel</a> was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentordersubmitcancellationrequest">FulfillmentOrderSubmitCancellationRequest</a> was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentorderacceptcancellationrequest">FulfillmentOrderAcceptCancellationRequest</a> was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentorderrejectcancellationrequest">FulfillmentOrderRejectCancellationRequest</a> was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentordersubmitfulfillmentrequest">FulfillmentOrderSubmitFulfillmentRequest</a> was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentorderacceptfulfillmentrequest">FulfillmentOrderAcceptFulfillmentRequest</a> was added.</li>
<li><a href="/docs/api/admin-graphql/latest/objects/fulfillmentorderrejectfulfillmentrequest">FulfillmentOrderRejectFulfillmentRequest</a> was added.</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/fulfillmentorderclose">FulfillmentOrderClose</a> was added.</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/fulfillmentordercancel">FulfillmentOrderCancel</a> was added.</li>
<li><a href="/docs/api/admin-graphql/latest/mutations/fulfillmentordermove">FulfillmentOrderMove</a> was added.</li>
</ul>
<p><strong>Updated mutations</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">fulfillment_orders_opt_in</code> optional argument was added to <a href="/docs/api/admin-graphql/latest/mutations/fulfillmentserviceupdate">FulfillmentServiceUpdate</a>.</li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Minor non-breaking changes</h3>
  </div>
  <div class="accordion-content">
    <p><strong>Updated fields and types</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">SHP</code> value was added to enum <a href="/docs/api/admin-graphql/latest/enums/currencycode"><code class="text-highlight text-highlight--grey">CurrencyCode</code></a></li>
<li><code class="text-highlight text-highlight--grey">GIP</code> value was added to enum <a href="/docs/api/admin-graphql/latest/enums/currencycode"><code class="text-highlight text-highlight--grey">CurrencyCode</code></a></li>
<li><code class="text-highlight text-highlight--grey">FKP</code> value was added to enum <a href="/docs/api/admin-graphql/latest/enums/currencycode"><code class="text-highlight text-highlight--grey">CurrencyCode</code></a></li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>New error code for maximum number of discounts created</h3>
  </div>
  <div class="accordion-content">
    <p>A better error code is returned when an app tries to create more than 20 million discounts or discount codes.</p>
<p><strong>Updated types</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">EXCEEDED_MAX</code> was added to enum <a href="/docs/api/admin-graphql/latest/objects/priceruleerrorcode"><code class="text-highlight text-highlight--grey">PriceRuleErrorCode</code></a></li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Set and query customer locales</h3>
  </div>
  <div class="accordion-content">
    <p>The Customer object type now includes a customer&#39;s locale.</p>
<p><strong>New fields</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">locale</code> was added to input object type <a href="/docs/api/admin-graphql/latest/input-objects/customerinput"><code class="text-highlight text-highlight--grey">CustomerInput</code></a></li>
<li><code class="text-highlight text-highlight--grey">locale</code> was added to object type <a href="/docs/api/admin-graphql/latest/objects/customer"><code class="text-highlight text-highlight--grey">Customer</code></a></li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Set minimum purchase amounts for discounts</h3>
  </div>
  <div class="accordion-content">
    <p>We added support for required minimum purchase amounts for discounts. When a discount requires a minimum amount, a customer&#39;s purchase needs to exceed that value to be eligible for the discount.</p>
<p><strong>Updated types</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">DiscountPurchaseAmount</code> was added to union type <a href="/docs/api/admin-graphql/latest/objects/discountcustomerbuysvalue"><code class="text-highlight text-highlight--grey">DiscountCustomerBuysValue</code></a></li>
</ul>
<p><strong>New types</strong></p>
<ul>
<li><a href="/docs/api/admin-graphql/latest/objects/discountpurchaseamount"><code class="text-highlight text-highlight--grey">DiscountPurchaseAmount</code></a> was added</li>
</ul>
<p><strong>New fields</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">amount</code> was added to <a href="/docs/api/admin-graphql/latest/objects/discountcustomerbuysvalueinput"><code class="text-highlight text-highlight--grey">DiscountCustomerBuysValueInput</code></a></li>
<li><code class="text-highlight text-highlight--grey">extraInfo</code> was added to <a href="/docs/api/admin-graphql/latest/objects/discountusererror"><code class="text-highlight text-highlight--grey">DiscountUserError</code></a></li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Translate delivery method definitions</h3>
  </div>
  <div class="accordion-content">
    <p>Delivery method definitions are now translatable resources. To learn more about delivery method definitions, refer to <a href="/docs/apps/build/purchase-options/deferred/delivery-and-deferment/build-delivery-profiles">Manage delivery profiles</a>. To learn more about translating resources, refer to <a href="/docs/api/admin-graphql/latest/queries/translatableResource#section-examples">Translating content with the API</a></p>
<p><strong>Updated types</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">DELIVERY_METHOD_DEFINITION</code> was added to enum <a href="/docs/api/admin-graphql/latest/enums/translatableresourcetype"><code class="text-highlight text-highlight--grey">TranslatableResourceType</code></a></li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Updates to delivery profiles</h3>
  </div>
  <div class="accordion-content">
    <p><strong>Updated fields</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">merchantOwnedOnly</code> argument was added to field <code class="text-highlight text-highlight--grey">QueryRoot.deliveryProfiles</code></li>
</ul>
<p><strong>New types</strong></p>
<ul>
<li><a href="/docs/api/admin-graphql/latest/objects/deliveryproductvariantscount"><code class="text-highlight text-highlight--grey">DeliveryProductVariantsCount</code></a> object type was added</li>
</ul>
<p><strong>New fields</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">productVariantsCountV2</code> was added to object type <a href="/docs/api/admin-graphql/latest/objects/deliveryprofile"><code class="text-highlight text-highlight--grey">DeliveryProfile</code></a></li>
<li><code class="text-highlight text-highlight--grey">DeliveryProfile.productVariantsCount</code> was deprecated in favor of <code class="text-highlight text-highlight--grey">productVariantsCountV2</code></li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Query all available locales</h3>
  </div>
  <div class="accordion-content">
    <p>You can query the full list of locales available for a shop to enable. Refer to the <a href="/docs/api/admin-graphql/latest/queries/shopLocales#section-examples">example for retrieving a shop&#39;s locales</a>.</p>
<p><strong>New types</strong></p>
<ul>
<li><a href="/docs/api/admin-graphql/latest/objects/locale"><code class="text-highlight text-highlight--grey">Locale</code></a> object was added</li>
</ul>
<p><strong>New fields</strong></p>
<ul>
<li> <code class="text-highlight text-highlight--grey">availableLocales</code> was added to <a href="/docs/api/admin-graphql/latest/objects/queryroot"><code class="text-highlight text-highlight--grey">QueryRoot</code></a></li>
</ul>
  </div>
</div>
  </div>
</div>


## Storefront API changes

Below are all the changes introduced in the 2020-01 version of the Storefront API.

<div class="accordion-container">
  <div class="accordion-controls">
    <button class="accordion-control" data-accordion-control-type="expand-all" type="button">Expand all</button>
  </div>
  <div class="accordion-content-container">
    <div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Maximum input array size for GraphQL operations <span id="maximum-input-size-storefront-api" class="heading-flag breaking"></span></h3>
  </div>
  <div class="accordion-content">
    <p>Input arguments that accept an array have a maximum size of 250. Queries and mutations return an error if an input array exceeds 250 items.</p>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Minor non-breaking changes</h3>
  </div>
  <div class="accordion-content">
    <p><strong>Updated fields and types</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">SHP</code> value was added to enum <a href="/docs/api/storefront/reference/common-objects/currencycode"><code class="text-highlight text-highlight--grey">CurrencyCode</code></a></li>
<li><code class="text-highlight text-highlight--grey">GIP</code> value was added to enum <a href="/docs/api/storefront/reference/common-objects/currencycode"><code class="text-highlight text-highlight--grey">CurrencyCode</code></a></li>
<li><code class="text-highlight text-highlight--grey">FKP</code> value was added to enum <a href="/docs/api/storefront/reference/common-objects/currencycode"><code class="text-highlight text-highlight--grey">CurrencyCode</code></a></li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Query the unit price of product variants</h3>
  </div>
  <div class="accordion-content">
    <p>You can now query unit measurement and price data for product variants to display per-unit prices (for example, <code class="text-highlight text-highlight--grey">$9.99 / 100 ml</code>).</p>
<p><strong>New types</strong></p>
<ul>
<li><a href="/docs/api/storefront/reference/products/unitpricemeasurementmeasuredunit"><code class="text-highlight text-highlight--grey">UnitPriceMeasurementMeasuredUnit</code></a> was added</li>
<li><a href="/docs/api/storefront/reference/products/unitpricemeasurementmeasuredtype"><code class="text-highlight text-highlight--grey">UnitPriceMeasurementMeasuredType</code></a> was added</li>
<li><a href="/docs/api/storefront/reference/products/unitpricemeasurement"><code class="text-highlight text-highlight--grey">UnitPriceMeasurement</code></a> was added</li>
</ul>
<p><strong>New fields</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">unitPrice</code> was added to <a href="/docs/api/storefront/reference/products/productvariant"><code class="text-highlight text-highlight--grey">ProductVariant</code></a></li>
<li><code class="text-highlight text-highlight--grey">presentmentUnitPrices</code> was added to <a href="/docs/api/storefront/reference/products/productvariant"><code class="text-highlight text-highlight--grey">ProductVariant</code></a></li>
<li><code class="text-highlight text-highlight--grey">unitPriceMeasurement</code> was added to <a href="/docs/api/storefront/reference/products/productvariant"><code class="text-highlight text-highlight--grey">ProductVariant</code></a></li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Retrieve new media types for products</h3>
  </div>
  <div class="accordion-content">
    <p>Products now support three types of media: images, 3D models, and videos. Use the Storefront API to retrieve a product&#39;s media and display it on the store&#39;s storefront.</p>
<p><strong>Updated types</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">media</code> was added to object type <a href="/docs/api/storefront/reference/products/product"><code class="text-highlight text-highlight--grey">Product</code></a></li>
</ul>
<p><strong>New types</strong></p>
<ul>
<li><a href="/docs/api/storefront/reference/products/videosource"><code class="text-highlight text-highlight--grey">VideoSource</code></a> was added</li>
<li><a href="/docs/api/storefront/reference/products/video"><code class="text-highlight text-highlight--grey">Video</code></a> was added</li>
<li><a href="/docs/api/storefront/reference/products/model3dsource"><code class="text-highlight text-highlight--grey">Model3dSource</code></a> was added</li>
<li><a href="/docs/api/storefront/reference/products/model3d"><code class="text-highlight text-highlight--grey">Model3d</code></a> was added</li>
<li><a href="/docs/api/storefront/reference/products/mediaimage"><code class="text-highlight text-highlight--grey">MediaImage</code></a> was added</li>
<li><a href="/docs/api/storefront/reference/products/externalvideo"><code class="text-highlight text-highlight--grey">ExternalVideo</code></a> was added</li>
<li><a href="/docs/api/storefront/reference/products/mediacontenttype"><code class="text-highlight text-highlight--grey">MediaContentType</code></a> was added</li>
<li><a href="/docs/api/storefront/reference/products/media"><code class="text-highlight text-highlight--grey">Media</code></a> was added</li>
</ul>
  </div>
</div>
<div class="accordion-item">
  <div class="accordion-link">
    <div class="chevron-up"></div>
    <div class="chevron-down"></div>
    <h3>Retrieve translated content with the Storefront API</h3>
  </div>
  <div class="accordion-content">
    <p>You can now retrieve translated content for select <a href="/docs/storefronts/headless/building-with-the-storefront-api/markets#translatable-resources">resource properties</a> using the Storefront API. You need to use the Accept-Language HTTP request header when sending queries. Before you can retrieve the content, it needs to be created using the <a href="/docs/api/admin-graphql/latest/objects/translationsregister">GraphQL Admin API</a>.</p>
<p>To learn more, refer to <a href="/docs/storefronts/headless/building-with-the-storefront-api/markets/multiple-languages">Support multiple languages on storefronts</a>.</p>
<p><strong>Supported resources</strong></p>
<ul>
<li><code class="text-highlight text-highlight--grey">Collection</code></li>
<li><code class="text-highlight text-highlight--grey">Metafield</code></li>
<li><code class="text-highlight text-highlight--grey">Article</code></li>
<li><code class="text-highlight text-highlight--grey">Blog</code></li>
<li><code class="text-highlight text-highlight--grey">Page</code></li>
<li><code class="text-highlight text-highlight--grey">Product</code></li>
<li><code class="text-highlight text-highlight--grey">ProductOption</code></li>
<li><code class="text-highlight text-highlight--grey">ProductVariant</code></li>
<li><code class="text-highlight text-highlight--grey">ShopPolicy</code></li>
</ul>
<p>For a full list of translatable properties, refer to <a href="/docs/storefronts/headless/building-with-the-storefront-api/markets#translatable-resources">Translatable resources</a>.</p>
  </div>
</div>
  </div>
</div>


### Corresponding Buy SDK versions

<table>
  <tr>
    <th>SDK</th>
    <th>Supported Versions</th>
  </tr>
  <tr>
    <td>Mobile Buy SDK Android</td>
    <td>4.0.0</td>
  </tr>
  <tr>
    <td>Mobile Buy SDK iOS</td>
    <td>3.7.0, 3.7.1</td>
  </tr>
  <tr>
    <td>Unity Buy SDK</td>
    <td>2.0.0</td>
  </tr>
  <tr>
    <td>JS Buy SDK</td>
    <td>2.9.0, 2.9.1,2.9.1, 2.9.2, 2.9.3</td>
  </tr>
  <tr>
    <td>Buy Button JS</td>
    <td>2.1.0, 2.1.1, 2.1.2</td>
  </tr>
</table>