# Using Wingman
Wingman helps you automate the process of adding items to your cart by using positive and negative keywords, size options, and price filters. It’s designed to catch items the instant they appear, helping you secure high-demand releases with ease. Wingman continuously scans for items that match your configured task filters. When it detects an in-stock variant, it automatically adds the item to your cart and opens your browser, allowing you to checkout faster and more efficiently.
Wingman task creation is **very** similar to normal Keywords but there are a few unique features. Keywords are still matched based on both your **positive** and **(optional) negative keywords** against both product titles and URLs for enabled stores and just like the normal Keyword mode. Since Wingman is again very similar to normal Keyword configuration we'd strongly advise you read the Keyword guidance first and foremost before exploring what Wingman has to offer.
When you first visit the Wingman page you will see the following placeholder which also directs you to the Wingman Crash Course:
To create a task simply click the (+) icon and then go through the simple set-up:
Side note: Wingman also supports ANY Shopify store via the 'Custom Shopify Store' input too!
***
* **Comma means AND:** Separate each word with a comma to require all of them in a single product.\
Example: `signed,vinyl` will only match products containing both *signed* and *vinyl*.
* **Case-insensitive:** Keywords are not case sensitive, “SIGNED” and “signed” behave exactly the same.
You can edit and duplicate an existing task via the menu icon beside the task:
You can also create a task in one click by selecting 'Create Wingman Task' on any item in the Unfiltered/Filtered/Live/Sale feed too. This will then give you a list of sizes and over-ride any keywords/price filters etc.
***
#### Wingman Features
**Negative Keywords *****(Optional)***
Exclude unwanted items by adding negative keywords.\
Example: a positive keyword group of `signed,vinyl` with a negative `poster` will skip any items that include *poster*.
**Price Filters *****(Optional)***
Set a minimum and/or maximum price to filter out low-value add-ons or overly expensive products.\
For example, you might exclude £0.00 “art cards” or cap tasks at £50 to stay within budget.
**Size Options**
Target specific size variants for supported stores. Selecting **Random/Any** will automatically choose the first available size when your task runs.
***
#### Examples
Just like the 'Keywords' configurations. Ignore these examples, they’re too broad or incorrectly formatted, and won’t produce accurate matches:
* `signed exclusive vinyl`
* `taylor swift vinyl cd poster`
* `sabrina carpenter signed`
**Correctly Formatted Examples:**
Use commas for **AND**, and refine with optional negatives or price filters if desired:
* `signed` *(with negative: cd, and with price filter min 5.00)*
The above example would then ignore any items which contain 'signed, cd' and cost less than '5.00' in the stores local currency. This would essentially help you avoid signed CD items but still locate signed other items such as vinyl.
* `exclusive,vinyl` *(with negative: poster)*
The above example would ignore any items that contain 'poster' which would then avoid any bundles which may contain an exclusive vinyl and poster set.
* `signed` *(with price filters: min 5.00, max 50.00)*
This example would locate any signed item but ignoring those priced below '5.00' or over '50.00', therefore avoiding things like free art cards (which can't normally be checked out on their own) as well as expensive bundles or items.
***
#### Usage Cases
* For countdowns or timed drops, configure your task and start it 5–10 seconds before launch. Wingman will continuously check, detect the item the moment it appears, and open your browser automatically, no waiting for notifications or manual refreshes required.
OR
* During busy restock periods, Wingman can catch low-quantity restocks instantly, giving you a better shot at high-demand items.
Extra tips:
* Running multiple tasks for the same store won’t improve performance. Keep it simple, one task per store is ideal.
* If several browser windows open in quick succession, it may hinder your checkout. Keep the setup lean for best results.
We would recommend;
* **Run for short windows:** As stated above, you should use Wingman during release or restock periods only. Keep the Wingman page open while tasks are active, it does not run in the background.
* **Iterate and refine:** Just like your keywords: Start simple, observe the results, then adjust your keywords, negatives, and price filters to better target what you want.
* **How many tasks?** While there’s no strict limit, we recommend running just a few tasks at once for stability/best performance on your device as well as to avoid the chance of multiple browsers opening at once and overwhelming you. MerchVault currently only allows you to run 3 tasks simultaneously but you can create as many tasks as you desire. This is to prevent users operating too many tasks and receiving unexpected/unintended results and/or data usage.
***
#### Storage & Sync
Unlike keywords, your Wingman tasks are only stored locally on your device and **do not sync across devices**.
***
#### Independent Vinyl Store Groups
You cannot create tasks for the *Independent Vinyl Store groups* via the Wingman page. To use Wingman with those stores, open the item from your feed and create the task via the **action menu** instead.
***
#### IMPORTANT // Limitations
* **Bundle Availability**
Certain stores may incorrectly display items as “in stock” when part of a bundle is unavailable. This is a store-side limitation, and unfortunately, Wingman cannot cross-verify availability in these cases.
* **Keyword Scanning**
Wingman scans products from a store’s backend feed, which may differ from what’s currently visible on the storefront. If your keywords aren’t matching visible products, we recommend creating a task directly from the item’s URL using the action sheet.
***
#### Task Statuses
**idle:** Task not running.\
**searching for product:** Checking every second for matching products.\
**waiting for variant:** Found product, checking for your selected size (try “Random/Any” if it stalls).\
**variant found:** Size detected, monitoring availability.\
**waiting for restock:** Selected size is sold out; checking every second for restock.\
**password page up:** Store temporarily locked; Wingman will resume automatically.\
**price filter exceeded:** Item matched, but outside your price limits; task stopped. Adjust filters to continue.\
**successfully opened in browser:** Task complete. Your browser has opened for checkout or add-to-cart completion.
---
# Agent Instructions: Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter:
```
GET https://merchvault.gitbook.io/merchvault/wingman/using-wingman.md?ask=
```
The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
