shopify-admin-split-shipment-planner

Split Shopify fulfillment orders into separate shipments using GraphQL mutations.

174|18|Updated Apr 11, 2026
One-click install
npx skills add https://github.com/40RTY-ai/shopify-admin-skills --skill shopify-admin-split-shipment-planner
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: shopify-admin-split-shipment-planner
Source: https://github.com/40RTY-ai/shopify-admin-skills/tree/main/skills/fulfillment-ops/shopify-admin-split-shipment-planner
Command: npx skills add https://github.com/40RTY-ai/shopify-admin-skills --skill shopify-admin-split-shipment-planner

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill solves the operational headache of manually splitting a multi-line fulfillment order when items must ship from different locations or require different carriers and tracking.

Core Features & Use Cases

  • Splits OPEN fulfillment orders into independent shipments: Creates multiple fulfillment orders so each group can ship independently with separate tracking.
  • Groups line items with quantity validation: Ensures provided line item IDs exist in the target fulfillment order and quantities do not exceed remaining quantities.
  • Supports safe previewing via dry runs: Lets you see the intended split outcome before executing the irreversible split mutation.

Example use case: An order is fulfilled from two warehouses and part of the items should ship later with a different carrier; you define split groups by line items and then split the fulfillment accordingly.

Quick Start

Use the skill to split fulfillment order <fulfillment_order_id> into shipments by specifying split_groups with the line_item_ids and quantities you want in each shipment, starting with dry_run true to verify the grouping.

Frequently Asked Questions about shopify-admin-split-shipment-planner

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I split a Shopify fulfillment order into multiple shipments for different warehouses?

You can split a Shopify fulfillment order by defining split groups containing specific line_item_ids and quantities. This separates a multi-line order into independent fulfillment orders so each group can ship separately with its own tracking.

Can I preview a Shopify fulfillment order split before executing it?

Yes, you can preview a fulfillment order split by running the operation with dry_run enabled. This shows the intended split outcome and validates line item quantities safely before executing the irreversible fulfillmentOrderSplit mutation.

What are the requirements to split a Shopify fulfillment order using GraphQL?

Splitting a Shopify fulfillment order requires an OPEN fulfillment order status and GraphQL read_fulfillmentOrders validation. Line item IDs must exist in the target order, and requested quantities cannot exceed the remaining unfulfilled quantities.

Why does my Shopify shipment splitting fail when grouping line items?

Shipment splitting fails when line_item_ids do not exist in the target fulfillment order or when requested quantities exceed remaining quantities. Validating inputs with a dry run first ensures the fulfillmentOrderSplit mutation executes successfully.

When do I need to split fulfillment orders in Shopify for operations automation?

You need to split fulfillment orders when items in a single order must ship from different locations, require different carriers, or have different shipping dates. This allows each warehouse or carrier group to process and track shipments independently.