Shopify Admin Return Initiation
Create a formal Shopify Return record for an order, specifying line items, quantities, and return reason — the first step in the native returns workflow.
Install
/plugin marketplace add 40RTY-ai/shopify-admin-skillsThe repo is a Claude Code plugin marketplace. Run /plugin afterwards to pick the plugin that includes this skill.
npx skills add 40RTY-ai/shopify-admin-skills --skill shopify-admin-return-initiationgit clone --depth 1 https://github.com/40RTY-ai/shopify-admin-skills.git /tmp/shopify-admin-skills
mkdir -p ~/.claude/skills
cp -r /tmp/shopify-admin-skills/skills/customer-support/shopify-admin-return-initiation ~/.claude/skills/shopify-admin-return-initiationPersonal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.
From the SKILL.md
## Purpose
Initiates a formal Shopify Return on a delivered order — specifying which line items to return, quantities, and reason. This creates the return record in Shopify's native returns system (distinct from simply issuing a refund). Used by support agents when a customer contacts them to return delivered items. The return record enables tracking, warehouse inspection, and exchange/refund resolution downstream. Note: `returnCreate` requires the order to be in `FULFILLED` status. For orders that haven't shipped yet, use `cancel-and-restock` instead. For already-returned items needing a refund, use `refund-and-reorder`.
## Prerequisites
- `shopify auth login --store <domain>`
- API scopes: `read_orders`, `write_returns`
## Parameters
| Parameter | Type | Required | Default | Description |
|-----------|------|----------|---------|-------------|
| store | string | yes | — | Store domain (e.g., mystore.myshopify.com) |
| format | string | no | human | Output format: `human` or `json` |
| dry_run | bool | no | false | Preview operations without executing mutations |
| order_id | string | yes | — | GID of the order (e.g., `gid://shopify/Order/12345`) |
| return_line_items | array | no | all fulfilled | Array of `{fulfillment_line_item_id, quantity, reason, reason_note}` to return |Details
- Skill name
shopify-admin-return-initiation- Repository
- 40RTY-ai/shopify-admin-skills
- Path
skills/customer-support/shopify-admin-return-initiation/SKILL.md- License
- MIT
- Repo updated
- 26 October 2026
FAQ
What does the Shopify Admin Return Initiation skill do?
Create a formal Shopify Return record for an order, specifying line items, quantities, and return reason — the first step in the native returns workflow.
How do I install the Shopify Admin Return Initiation skill?
Claude Code plugin: /plugin marketplace add 40RTY-ai/shopify-admin-skills. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.
Is Shopify Admin Return Initiation popular?
It lives in 40RTY-ai/shopify-admin-skills, which has 204 GitHub stars and 23 forks.
Related skills
Shopify Admin Abandoned Cart Recovery
20440RTY-ai/shopify-admin-skills
Query checkouts abandoned in the last N days, generate unique discount codes per customer, and tag them for re-engagement.
Shopify Admin Address Correction
20440RTY-ai/shopify-admin-skills
Update the shipping address on an unfulfilled order before it ships.
Shopify Admin Agentic Crawler Access
20440RTY-ai/shopify-admin-skills
Edit the theme's robots.txt.liquid to explicitly allow AI crawlers (GPTBot, ClaudeBot, PerplexityBot, Google-Extended, OAI-SearchBot, Amazonbot) so AI assistants are permitted to read the catalog.
Shopify Admin Return Processing Sla
20440RTY-ai/shopify-admin-skills
Read-only: measures average time from return request to refund completion, surfacing SLA breaches.
Shopify Admin Return Fraud Detector
20440RTY-ai/shopify-admin-skills
Read-only: identifies customers with abnormal return behavior — high return rate, wardrobing patterns, or serial returner profiles — for manual review.
Shopify Admin Return Reason Analysis
20440RTY-ai/shopify-admin-skills
Read-only: aggregates return reasons across orders to identify product quality or listing issues.
Browse the most popular Claude skills, all marketing, sales & business skills, or write your own with the skills generator.