shopify-admin-return-initiation

Create Shopify return records for fulfilled orders with line items and reasons.

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

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Support teams need a fast, accurate way to initiate a return for delivered orders without manually recreating Shopify’s native returns workflow.

Core Features & Use Cases

  • Initiates native return records: Creates a formal Shopify Return for fulfilled orders with selected line items, quantities, and a return reason.
  • Supports per-item return reasons: Enables reason tracking at the line-item level for better returns analytics.
  • Controls customer notification: Can notify the customer when initiating the return, or run silently for internal workflows.
  • Guardrailed execution: Prevents initiation on non-fulfilled orders and supports safe previews via dry run.

Quick Start

Ask the AI to create a Shopify return for order gid://shopify/Order/12345, returning the appropriate fulfillment line items with the correct return reason, using dry_run set to true first.

Frequently Asked Questions about shopify-admin-return-initiation

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

FAQPage Schema
How do I create a Shopify return record for a delivered order?

Initiating a Shopify return record requires querying the order to verify FULFILLED status, then running the returnCreate GraphQL mutation with selected fulfillment line items, quantities, and return reasons.

Can I preview a Shopify return initiation before committing the changes?

Yes, you can preview a Shopify return initiation safely by setting dry_run to true, allowing you to validate the selected fulfillment line items and return reasons without creating a formal record.

Does initiating a Shopify return automatically process a customer refund?

No, initiating a Shopify return does not automatically process a refund. It creates a formal native return record to start tracking returned fulfillment line items separately from the refund workflow.

How do I track different return reasons for individual items in a Shopify order?

You can track per-item return reasons by specifying distinct return reason inputs for each fulfillment line item within the returnCreate GraphQL mutation during the Shopify return initiation process.

Why does my Shopify order return initiation fail with a status error?

Shopify return initiation fails if the order lacks a FULFILLED status. The process includes a guardrail that queries the order first to prevent initiating returns on non-fulfilled orders.

Can I initiate a Shopify return without sending a customer notification?

Yes, you can control customer notification during Shopify return initiation to run silently for internal support workflows, or optionally notify the customer when the return record is created.