Scope types reference

Scope type	Match value format	Default priority	Notes
product	Shopify Product GID	100	Highest priority — overrides all others
tag	Plain string	80	Case-sensitive match
collection	Shopify Collection GID	60	Both manual and smart collections
product_type	Plain string	40	Matches Shopify productType field
vendor	Plain string	20	Case-sensitive
category	Shopify Category full path	15	E.g. Apparel > Tops > T-Shirts
sku_prefix	Plain string	10	Matches SKU substring before first -
location	Shopify Location ID	5	Matches if product has inventory at this location

Choosing a scope

Pick the broadest scope that captures your intent. Examples:

• "All my Nike products" → vendor: Nike
• "Everything in this Shopify collection" → collection: gid://...
• "This specific hero product" → product: gid://...
• "All winter coats this season" → tag: ss24-winter

Multiple rules matching the same product

When more than one rule's scope matches a single product, the highest-priority rule wins. Default priorities ensure specific-over-general behaviour:

product (100) > tag (80) > collection (60) > product_type (40)
  > vendor (20) > category (15) > sku_prefix (10) > location (5)

You can override priority on any rule to force different behaviour.