Action types reference
Parameters and Shopify mutations for every action type
| Type | Parameters | Shopify mutation |
|---|---|---|
markdown |
{ percent: 1..95 } |
productVariantsBulkUpdate (price) |
sale_badge |
{ percent: 1..95 } |
productVariantsBulkUpdate (price + compareAtPrice) |
clearance_price |
{ percent: 1..95 } |
productVariantsBulkUpdate (price + compareAtPrice) |
add_tag |
{ tag: "string" } |
productUpdate (tags) |
add_to_collection |
{ collectionId: "gid://..." } |
collectionAddProducts |
unpublish |
(none) | productUpdate (status=DRAFT) |
archive |
(none) | productUpdate (status=ARCHIVED) |
Markdown vs Sale badge vs Clearance
All three change variant prices, but with different visibility on the storefront:
- Markdown — sets only
price. No "on sale" indicator unless your theme infers from cost-per-item. - Sale badge — sets both
price(discounted) andcompareAtPrice(original). Themes show strikethrough. - Clearance price — same mechanics as sale badge but with higher default discount (40% vs 20%).
Revert behaviour
Each action records the data needed to undo it. Reverting is idempotent — calling revert on an already-reverted product is a no-op.