# FulfillmentHold - admin-graphql - OBJECT Version: 2025-01 ## Description A fulfillment hold currently applied on a fulfillment order. ### Access Scopes `read_assigned_fulfillment_orders` access scope, `read_merchant_managed_fulfillment_orders` access scope, `read_third_party_fulfillment_orders` access scope or `read_marketplace_fulfillment_orders` access scope. ## Fields * [displayReason](/docs/api/admin-graphql/2025-01/scalars/String): String! - The localized reason for the fulfillment hold for display purposes. * [handle](/docs/api/admin-graphql/2025-01/scalars/String): String - An identifier an app can use to reference one of many holds it applied to a fulfillment order. This field must be unique among the holds that a single app applies to a single fulfillment order. * [heldByApp](/docs/api/admin-graphql/2025-01/objects/App): App - The app that created the fulfillment hold. * [heldByRequestingApp](/docs/api/admin-graphql/2025-01/scalars/Boolean): Boolean! - A boolean value that indicates whether the requesting app created the fulfillment hold. * [id](/docs/api/admin-graphql/2025-01/scalars/ID): ID! - A globally-unique ID. * [reason](/docs/api/admin-graphql/2025-01/enums/FulfillmentHoldReason): FulfillmentHoldReason! - The reason for the fulfillment hold. * [reasonNotes](/docs/api/admin-graphql/2025-01/scalars/String): String - Additional information about the fulfillment hold reason. ## Connections ## Related queries ## Related mutations * [fulfillmentOrderHold](/docs/api/admin-graphql/2025-01/mutations/fulfillmentOrderHold) Applies a fulfillment hold on a fulfillment order. As of the [2025-01 API version](https://shopify.dev/changelog/apply-multiple-holds-to-a-single-fulfillment-order), the mutation can be successfully executed on fulfillment orders that are already on hold. To place multiple holds on a fulfillment order, apps need to supply the [handle](https://shopify.dev/api/admin-graphql/latest/objects/FulfillmentHold#field-handle) field. Each app can place up to 10 active holds per fulfillment order. If an app attempts to place more than this, the mutation will return [a user error indicating that the limit has been reached](https://shopify.dev/api/admin-graphql/latest/enums/FulfillmentOrderHoldUserErrorCode#value-fulfillmentorderholdlimitreached). The app would need to release one of its existing holds before being able to apply a new one. ## Related Unions ## Examples