Skip to main content
Headless CLISites + products
Headless CLI

Sites + products

Create and maintain sites and products from scripts instead of clicking through the dashboard.

Subcommands for sites, products, variants, collections, media, coupons, and memberships.

Most CLI workflows revolve around sites and the content inside them — products, variants, collections, coupons, media. The subcommands below cover the common ones.

Sites

bash
# Listaly-store-cli sites list # Get (by id or slug)aly-store-cli sites get acme # Createaly-store-cli sites create --slug acme --title "Acme Store" # Update theme / settingsaly-store-cli sites update acme --setting cryptoPaymentsEnabled=true # Publish / unpublishaly-store-cli sites publish acmealy-store-cli sites unpublish acme # Delete (requires delete:sites)aly-store-cli sites delete acme

Products

bash
# List on a sitealy-store-cli products list --site-slug acme # Getaly-store-cli products get prod_abc --json # Createaly-store-cli products create \  --site-slug acme \  --name "Linen Tote" \  --slug linen-tote \  --price-usd 42.00 \  --tags "bags,linen" # Updatealy-store-cli products update prod_abc --price-usd 39.00 # Deletealy-store-cli products delete prod_abc

Variants

bash
# Createaly-store-cli variants create prod_abc \  --option color=natural \  --stock 25 \  --sku LT-NAT # Update stock or pricealy-store-cli variants update var_1 --stock 50aly-store-cli variants update var_1 --price-usd 45.00 # Deletealy-store-cli variants delete var_1

Collections

bash
# Create a manual collectionaly-store-cli collections create \  --site-slug acme \  --slug spring-2026 \  --title "Spring 2026" # Attach / detach productsaly-store-cli collections attach spring-2026 prod_abc prod_defaly-store-cli collections detach spring-2026 prod_abc

Media

bash
# Upload a file (CLI requests a signed PUT URL, streams, then finalizes)aly-store-cli media upload ./tote-front.jpg --site-slug acme # Listaly-store-cli media list --site-slug acme # Attach to a productaly-store-cli products media-attach prod_abc media_xy --alt "Front view"

Coupons

bash
aly-store-cli coupons create \  --site-slug acme \  --code WELCOME10 \  --type percent_off \  --value 10 \  --max-uses 500 \  --valid-until 2026-12-31

Memberships

bash
aly-store-cli memberships create \  --site-slug acme \  --title "Pro" \  --price-usd 9.00 \  --interval month

Output

Every command supports --json for machine output. The human form is plain text optimized for tail-piping; --json emits the canonical resource representation that mirrors the REST API response.

Updated

Was this page helpful?