shopify-admin-customer-spend-tier-tagger

Purpose

Queries all customers, calculates their lifetime spend using order history, and assigns a spend-tier tag (Bronze/Silver/Gold/Platinum by default). Enables VIP segmentation for loyalty programs, exclusive offers, and CX prioritization without a third-party loyalty app. Extends the existing loyalty-segment-export skill with a write step.

Prerequisites

• Authenticated Shopify CLI session: shopify store auth --store <domain> --scopes read_customers,read_orders,write_customers
• API scopes: read_customers, read_orders, write_customers

Parameters

Parameter	Type	Required	Default	Description
store	string	yes	—	Store domain (e.g., mystore.myshopify.com)
tiers	object	no	see below	Spend thresholds per tier (in store currency)
tag_prefix	string	no	tier	Tag prefix (e.g., tier:bronze, tier:silver)
remove_old_tiers	bool	no	true	Remove existing tier tags before applying new ones
dry_run	bool	no	true	Preview without executing mutations
format	string	no	human	Output format: human or json

Default tiers (store currency):

bronze:   $0–$249
silver:   $250–$999
gold:     $1,000–$4,999
platinum: $5,000+

Safety

⚠️ tagsAdd adds tags to customer records visible to staff and used by marketing segments. If remove_old_tiers: true, existing tier tags matching tag_prefix are removed before new ones are applied. Run with dry_run: true to review the tier distribution before committing.

Workflow Steps

1. OPERATION: customers — query Inputs: first: 250, select id, amountSpent, pagination cursor Expected output: All customers with lifetime spend; paginate until hasNextPage: false

2. Assign tier to each customer based on amountSpent.amount vs. tiers thresholds

3. OPERATION: orders — query (optional — for verification of spend figures)

4. OPERATION: tagsAdd — mutation Inputs: Customer id, tags: ["<tag_prefix>:<tier>"] Expected output: Updated customer tags; userErrors