Shopify Admin Product Image Audit

Purpose

Scans all active products and their variants for missing or insufficient images. Flags products with zero images, variants with no assigned image, and products below a minimum image count threshold. Read-only — no mutations.

Prerequisites

• Authenticated Shopify CLI session: shopify store auth --store --scopes read_products
• API scopes: read_products

Parameters

| Parameter | Type | Required | Default | Description | |-----------|------|----------|---------|-------------| | store | string | yes | — | Store domain (e.g., mystore.myshopify.com) | | minimages | integer | no | 1 | Flag products with fewer than this many images | | checkvariants | bool | no | true | Also flag variants with no assigned image | | status_filter | string | no | active | Product status to scan: active, draft, or all | | format | string | no | human | Output format: human or json |

Safety

> ℹ️ Read-only skill — no mutations are executed. Safe to run at any time.

Workflow Steps

1. OPERATION: products — query

Inputs: query: "status:", first: 250, select images, variants { image }, pagination cursor Expected output: Products with image counts and variant image assignments; paginate until hasNextPage: false

1. Flag products: `images.count ║

║ Started: ║ ╚══════════════════════════════════════════════╝

**After each step**, emit:

[N/TOTAL] → Params: → Result:

**On completion**, emit:

For `format: human` (default):

══════════════════════════════════════════════ PRODUCT IMAGE AUDIT Products scanned: Missing all images: Below min (): Variants missing image:

Products needing images: "" — 0 images "" — 1 image (below min ) Output: imageaudit.csv ══════════════════════════════════════════════

For `format: json`, emit:
```json
{
  "skill": "product-image-audit",
  "store": "",
  "min_images": 1,
  "products_scanned": 0,
  "missing_all_images": 0,
  "below_minimum": 0,
  "variants_missing_image": 0,
  "output_file": "image_audit_.csv"
}

Output Format

CSV file image_audit_.csv with columns: product_id, product_title, handle, image_count, issue, variant_id, variant_sku, variant_has_image

Error Handling

| Error | Cause | Recovery | |-------|-------|----------| | THROTTLED | API rate limit exceeded | Wait 2 seconds, retry up to 3 times | | No products match filter | Empty catalog or wrong status filter | Exit with 0 results |

Best Practices

• Products with zero images cannot be sold on most sales channels (Google Shopping, Meta, etc.) — prioritize these as urgent.
• For apparel or products with color/size variants, set min_images: 3 to ensure at least one front, back, and lifestyle shot per product.
• Run after bulk product imports to catch images that failed to upload in the import batch.
• Pair with product-data-completeness-score for a single comprehensive catalog quality report.

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.