Two pieces
- An inbound shipping rule — Direction = Inbound (Return), with a return product.
- On the outbound rule you ship with, Return Shipping Rule points at that inbound rule.
Inbound shipping rule
Shipping Rules → Add Shipping Rule. Direction helper: Outbound for regular shipments, inbound for returns. Options: Outbound, Inbound (Return).

Direction — Outbound or Inbound (Return)


Inbound (Return) product list — GLS ShopReturn and Pick&Return
Attach it on the outbound rule
Open the outbound rule. Return Shipping:

Return Shipping — Return Shipping Rule None until you pick an inbound rule
Use auto-create when every outbound send should book a return. Leave it off when returns are the exception.
Create an inbound shipment by hand
Shipments → Create shipment. Type *: Outbound (default) or Inbound. Placeholder Select type. When Type is Inbound:

Create shipment with Type Inbound — Receiver Address
create-shipment-from-order) is always outbound. Use this create form (or Create Return below) for inbound.
Reference * placeholder e.g., ORDER-12345. Parties, parcels, and send: Create a shipment, Send a shipment. Filter the list with Type = Inbound — Search and filters.
Create Return Shipment (from a dispatched outbound)
Shipment header
On a shipment Overview, Create Return Shipment (busy: Creating Return…) appears only when all of these are true:- Status is Dispatched
- Type is Outbound
- The shipment’s shipping rule has Return Shipping Rule set
- Auto-create return on dispatch is off
POST /orgs/:orgId/shipments/:shipmentId/create-return.
Order Shipments tab
Overflow Create Return (busy: Creating Return…) uses the order’s shipping rule (returnShippingRuleId / autoCreateReturnShipment), not the shipment’s. Same dispatched + outbound checks.
The API still resolves the shipment’s rule first, then the order’s, when it builds the return.
The docs org’s example shipments have no return rule, so Create Return Shipment is not on those screenshots. Configure the outbound rule first, dispatch, then the header action appears. Do not expect the button on a shipment that was booked without a return rule.
What gets created
Toasts: Return shipment created successfully / Failed to create return shipment. Orders tab uses the same success copy.
Automations
The builder includes action Create Return Shipment (action.shipment.create-return) with optional Return shipping rule. Configure it on Automations — do not duplicate the inspector here.
Related
- Returns
- Shipping rule fields
- Sender addresses
- Send a shipment
- Search and filters
- Shopify settings — checkout rates are outbound; returns are merchant-side