---
title: >-
  Improved user errors on the fulfillmentOrderMove mutation - 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/fulfillment-order-move-mutation-error-codes'
  md: 'https://shopify.dev/changelog/fulfillment-order-move-mutation-error-codes.md'
metadata:
  effectiveApiVersion: 2026-04
  affectedApi:
    - displayName: Admin GraphQL API
      handle: admin-graphql
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Update
    handle: update
  indicatesActionRequired: false
  createdAt: '2025-10-14T10:49:40-04:00'
  postedAt: '2026-04-01T00:00:00-04:00'
  updatedAt: '2026-02-02T09:59:35-05:00'
  effectiveAt: '2026-01-01T00:00:00-05:00'
---

April 1, 2026

Tags:

* Admin GraphQL API
* 2026-04

# Improved user errors on the `fulfillmentOrderMove` mutation

The `fulfillmentOrderMove` mutation now returns a specific `fulfillmentOrderMoveUserError` type instead of the generic `userError` type.

## What's changing:

The user error response now includes a code field for easier programmatic error handling and identification.

## Why we made this change:

This enhancement supports the new manual in-progress fulfillment orders feature, which allows merchants to self-report progress on their fulfillment orders. As part of this feature, moving fulfillment orders with reported progress is now restricted, and the enhanced error responses help developers handle these restrictions more effectively.

## Learn more

[Learn more about the `fulfillmentOrderMove` mutation](https://shopify.dev/docs/api/admin-graphql/latest/mutations/fulfillmentOrderMove).