---
title: >-
  Update to fulfillmentHold.heldByApp field from fulfillmentHold.heldBy field -
  Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/update-to-fulfillmenthold-heldbyapp-field-from-fulfillmenthold-heldby-field
  md: >-
    https://shopify.dev/changelog/update-to-fulfillmenthold-heldbyapp-field-from-fulfillmenthold-heldby-field.md
metadata:
  effectiveApiVersion: 2025-01
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: true
  createdAt: '2024-10-24T07:45:12-04:00'
  postedAt: '2024-10-24T07:23:00-04:00'
  updatedAt: '2024-10-30T05:25:52-04:00'
  effectiveAt: '2024-10-24T07:23:00-04:00'
---

October 24, 2024

Tags:

* Action Required
* Admin GraphQL API
* 2025-01

# Update to `fulfillmentHold.heldByApp` field from `fulfillmentHold.heldBy` field

As of the `2025-01` API version, the `heldBy` string field on the `fulfillmentHold` GraphQL object will be replaced by the newly introduced [`heldByApp`](https://shopify.dev/docs/api/admin-graphql/unstable/objects/fulfillmentHold#field-heldbyapp) object field.

This new field provides access to all attributes of the [App object](https://shopify.dev/docs/api/admin-graphql/2025-01/objects/app), unlike the deprecated `heldBy` field, which only indicated the app's title.

If you currently query `fulfillmentHold.heldBy`, you should transition to querying `fulfillmentHold.heldByApp.title`.