Catalyst Creations Apps
Install App
Back to Home
App Technical Documentation

SKU Bulk Generator Specifications

Comprehensive guide to SKU pattern syntax, automatic webhook triggers, catalog batch limits, and Shopify API integration.

1. System Overview

App architecture & scopes

2. Token Syntax

Pattern placeholder variables

3. Webhooks & Sync

Auto-generation triggers

1. System Overview & Shopify Scopes

SKU Bulk Generator is built on Next.js, Node.js background workers, and PostgreSQL. It interfaces directly with Shopify via the official GraphQL Admin API (version 2026-07) to query catalog structures and mutate product variant SKU attributes.

Required Shopify OAuth Scopes:

  • ✓ write_products (Used to update SKU strings on ProductVariants)
  • ✓ read_products (Used to query titles, options, vendors, and types)
  • ✓ read_inventory (Used to verify multi-location SKU alignment)

2. Rule Pattern Token Syntax Reference

You can combine tokens, custom literal strings, and separators (hyphen -, underscore _, slash /, or none) to form your SKU template.

Token SyntaxDescriptionSample Output
{VENDOR}Product Vendor initials or nameURBAN
{PRODUCT_TITLE}First N characters of Product TitleJACKET
{OPTION_1}Value of 1st Variant Option (e.g. Size)LARG
{OPTION_2}Value of 2nd Variant Option (e.g. Color)BLUE
{AUTO_INC}Sequential counter with padding (0001)0042
{BARCODE}Existing barcode/UPC string8492048291

3. Automated Webhooks & Rate-Limit Safety

SKU Bulk Generator uses Shopify mandatory webhooks (products/create, products/update) registered via GraphQL webhook subscriptions.

GraphQL Leaky Bucket Safety

Batch mutations automatically throttle according to Shopify cost limits (50 points/sec) to avoid rate limit HTTP 429 exceptions.

1-Click Rollback Logs

Every bulk update captures a pre-execution JSON snapshot of variant SKUs, enabling instant rollback if rules are misconfigured.