Shopify Admin Automated Order Tagger

Purpose

Applies tags to orders based on configurable rule sets — geography-based (domestic/international), value-based (high-value, low-value), product-type-based, customer-tier-based, or custom conditions. Supports dry-run mode for safe preview.

Prerequisites

• Authenticated Shopify CLI session: shopify store auth --store --scopes read_orders,write_orders
• API scopes: read_orders, write_orders

Parameters

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | store | string | yes | — | Store domain | | rules | object[] | yes | — | Array of tagging rules (see Rules Format below) | | daysback | integer | no | 7 | Lookback window for orders to tag | | skiptagged | boolean | no | true | Skip orders that already have the target tag | | dry_run | boolean | no | true | Preview only — don't apply tags | | format | string | no | human | Output format: human or json |

Rules Format

Each rule has a condition and a tag:

[
  { "condition": "total_price > 500", "tag": "high-value" },
  { "condition": "total_price  5", "tag": "bulk-order" },
  { "condition": "customer_orders > 3", "tag": "repeat-buyer" },
  { "condition": "customer_orders = 1", "tag": "first-time" },
  { "condition": "risk_level = HIGH", "tag": "needs-review" },
  { "condition": "financial_status = PARTIALLY_REFUNDED", "tag": "partial-refund" },
  { "condition": "fulfillment_status = null", "tag": "unfulfilled" },
  { "condition": "discount_codes contains WELCOME", "tag": "welcome-discount" },
  { "condition": "product_type contains Subscription", "tag": "subscription-order" }
]

Safety

> ⚠️ Mutation skill — always run with dry_run: true first to preview tag assignments before applying.

Workflow Steps

1. OPERATION: orders — query

Inputs: query: "created_at:>=''", first: 250, select id, name, tags, totalPriceSet, shippingAddress { countryCode }, customer { numberOfOrders }, displayFinancialStatus, displayFulfillmentStatus, riskLevel, lineItems { product { productType } }, discountCodes, pagination cursor Expected output: All recent orders with data needed for rule evaluation

1. For each order, evaluate all rules:

• Parse each condition against order data
• Collect all matching tags
• If skip_tagged: true, exclude tags already present on the order

1. If dry_run: true: report matches without applying

If dry_run: false:

1. OPERATION: orderUpdate — mutation (for each order needing new tags)

Inputs: { id: , tags: } Expected output: Updated order with new tags Batch: Process in batches of 10 to respect rate limits

GraphQL Operations

# orders:query — validated against api_version 2025-01
query OrdersForTagging($query: String!, $after: String) {
  orders(first: 250, after: $after, query: $query) {
    edges {
      node {
        id
        name
        tags
        totalPriceSet { shopMoney { amount currencyCode } }
        shippingAddress { countryCode provinceCode }
        customer { id numberOfOrders }
        displayFinancialStatus
        displayFulfillmentStatus
        riskLevel
        discountCodes
        lineItems(first: 20) {
          edges {
            node {
              product { productType }
              quantity
            }
          }
        }
      }
    }
    pageInfo { hasNextPage endCursor }
  }
}

# orderUpdate:mutation — validated against api_version 2025-01
mutation TagOrder($input: OrderInput!) {
  orderUpdate(input: $input) {
    order { id name tags }
    userErrors { field message }
  }
}

Session Tracking

Claude MUST emit the following output at each stage. This is mandatory.

On start, emit:

╔══════════════════════════════════════════════╗
║  SKILL: Automated Order Tagger               ║
║  Store:                        ║
║  Mode:                       ║
║  Started:              ║
╚══════════════════════════════════════════════╝

After each step, emit:

[N/TOTAL]   
          → Params: 
          → Result: 

On completion, emit:

For format: human (default):

══════════════════════════════════════════════
ORDER TAGGING REPORT  ( days, )
  Orders scanned:    
  Orders matched:    
  Tags applied:        (or "would apply" in dry run)
  ─────────────────────────────
  RULE MATCHES:
    "high-value"       →  orders
    "international"    →  orders
    "first-time"       →  orders
    "repeat-buyer"     →  orders

  Output: order_tags_.csv
══════════════════════════════════════════════

Output Format

CSV file order_tags_.csv with columns: order_id, order_name, existing_tags, new_tags, matched_rules

Error Handling

| Error | Cause | Recovery | |-------|-------|----------| | THROTTLED | API rate limit exceeded | Wait 2 seconds, retry up to 3 times | | Invalid rule | Unparseable condition | Skip rule, warn in output | | ACCESS_DENIED | Missing write_orders scope | Switch to read-only mode, report matches only |

Best Practices

• Always run dry_run: true first to preview changes.
• Tags are additive — this skill never removes existing tags.
• Use with order-risk-report to auto-tag risk levels.
• Combine with downstream automation tooling for post-tagging actions (e.g., tag "high-value" → assign to VIP fulfillment queue).
• Useful for filtering orders in Shopify admin — tags make complex order segments searchable.

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: 40RTY-ai
• Source: 40RTY-ai/shopify-admin-skills
• License: MIT
• Homepage: http://skills.40rty.ai

Install and usage instructions live in the source repository linked above.