Guides
Matching products
target picks the products, variants or slots a watcher looks at. Conditions only run on those.
Match modes
match | query | Watches |
|---|---|---|
url | A full URL | That page, if its host is in where.sites |
sku | A GTIN, style code or ASIN | That product on every listed site |
exact | A name with its version | That version only |
line | Words | Any version or product with those words in its name |
category | Words, or attributes.category | Anything in the category |
listing | A listing URL | Dated slots, like campsite nights |
Versions
We read a name as a line, a version and modifiers, so "Ghost 16 GTX" is the Ghost line, version 16, modifier GTX.
| Query | exact matches | exact skips |
|---|---|---|
Vomero 13 | Vomero 13 | Vomero 13 GTX, Vomero 14 |
Vomero 13 GTX | Vomero 13 GTX | Vomero 13 |
With line, any version matches, so you can add a version condition like > 13 to catch new releases. Products without version numbers match when the name has your words as whole words, so "Q1" matches "Keychron Q1 Max".
Attributes
attributes narrows the variants on a page:
"attributes": { "size": 10, "color": "Black" }- A list matches any of its values:
"size": [10, 10.5]. - Color matches whole words, so "Black" matches "Black/White-Anthracite".
- Shopify options use the store's option name in lower case, like
size,color,switchesorlayout. "auction": truekeeps only auctions on sites that mark them, like eBay and Reverb. On eBay it also searches for auctions ending soonest, since an eBay search is otherwise mostly Buy It Now.category,from,to,release_dateandopens_attell the site what to look for and don't filter variants.
Exclude
exclude drops any product whose name has one of its phrases as whole words, before conditions run.
"exclude": ["Vomero 5", "Vomero Plus"]"Vomero 5" drops "Vomero 5 SE" but keeps "Vomero 15", and "Vomero Plus" also drops "Vomero Plus 2".