---
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/posts/fulfillment-order-move-mutation-error-codes
  md: >-
    https://shopify.dev/changelog/posts/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

# Improved user errors on the `fulfillmentOrderMove` mutation

DateApril 1, 2026

Version[2026-04](https://shopify.dev/changelog?api_version=2026-04)

FlagsUpdate

SurfacesAPI

Affected APIs[Admin GraphQL API](https://shopify.dev/changelog?api_type=admin-graphql)

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