# Shopify

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FlpnJEGyWHT7LHuE6LrEk%2Flogo-bestpractices-old-small-9d48f4906860fcf2c2f4257abede5f6f8d6fbc8f6fe7473e06998c136d77d963.png?alt=media&#x26;token=1d6cce14-b5bf-4f61-94d6-25691ea3ed1f" alt=""><figcaption></figcaption></figure>

Our Shopify module supports both guest and account based checkout and is designed to handle a wide range of default and custom Shopify powered sites, from password protected launches to queue based and fast first come first serve restocks. Because Shopify stores vary heavily in protection, Stellar combines preload logic, flexible product identification (URLs, keywords, variants), multicart support and captcha harvesting to help secure checkouts efficiently. This module is ideal for sneakers, apparel, collectibles and limited releases across Shopify sites that sell out quickly and often require captcha solving.

***

### **Preliminary Checklist**

Before setting up tasks on Shopify, make sure you have everything below prepared:

* [ ] **Profiles**

> Create and save your checkout [profiles](https://guides.stellaraio.com/stellar/navigating-stellaraio/what-is-the-profiles-tab/how-do-i-add-a-profile) under the **Profiles tab** in Stellar. These contain your billing, shipping and payment info.

* [ ] **Proxies**

> - **ISP proxies** – Recommended for some of your tasks
> - **Residential proxies** – Recommended for majority of your tasks
>   * Save both proxy groups under the **Proxies tab** in Stellar.
>     * If you're looking for proxies, check out [Stella Proxies](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/stella-proxies) for high quality ISP and Residential proxies
>     * **please note** if you use residential proxies as a checkout proxy it **WILL** still use data if running long periods of time, run with caution.

* **Cook Group Access**

> Optional but recommended. Your [cook group](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/cook-groups) can help you find product URLs, SKUs and early restock alerts.

* **Test Task**

> Before big drops, run a **test task** on a random in stock product to confirm your profile, account, proxies and delays are functioning correctly.

***

### **Captcha Harvesters** <a href="#h_ebe5f62d74" id="h_ebe5f62d74"></a>

If the website you're trying to bot has Captchas, you'll need to have Captcha Harvesters setup. You can follow the Captcha Harvesters guide [here](https://guides.stellaraio.com/stellar/navigating-stellaraio/what-is-the-captchas-tab/how-do-i-set-up-the-captcha-harvester).

Make sure you're using a Gmail with a One Click status and has a good gmail score inside the Captcha Harvester. Once you've logged into your Gmail and saved the information, the Solvers will open automatically when necessary while running your tasks. You can also open the Captcha Harvester before starting any Shopify tasks.

Be prepared you'll have to solve at least one captcha per task as some Shopify sites may have multiple checkpoint captchas and sometimes checkout captchas.

***

### Adding a Custom Shopify Site

If the Shopify store you want to bot isn’t listed in the **Site** dropdown, follow the steps below:

#### Add the Store to the Dropdown

1. Go to the **Settings** tab in Stellar
2. Navigate to: **Shopify → Shopify Stores**

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FZo6SwyiRCk93IVNcTgQV%2Fimage.png?alt=media&#x26;token=d30cae02-e489-4f51-882c-47fb5e364fd5" alt=""><figcaption></figcaption></figure>

3. Add the store URL you want to use
   1. Example:

      ```
      https://example.com/
      ```
4. Save your changes

Once added, the store will appear in the **Site** dropdown when creating Shopify tasks.

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FvSeVg65qLa7ZyYseRO8b%2Fimage.png?alt=media&#x26;token=e57db52a-8ac8-4b26-af12-7f34871232cb" alt="" width="375"><figcaption></figcaption></figure>

**Tip:** Always use the store’s main domain (not a product link) when entering a custom Site URL.

***

### **Shopify Accounts** <a href="#h_944380e6b6" id="h_944380e6b6"></a>

To add your Shopify accounts to Stellar, follow the steps below<br>

1\. Go to **Identities** **tab** and click on the **Accounts** folder. You'll see **Shopify** there

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2Fz5DcZbUve1oj6tzE98jT%2Fshopifyaccounts.PNG?alt=media&#x26;token=abdd9660-022c-4eb0-91dd-0cf89d637da2" alt=""><figcaption></figcaption></figure>

2\. Click **Add Account** button

<div align="left"><figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FR1ONClHaS0WuobPE06EK%2FAdd%20Account.png?alt=media&#x26;token=39356015-cdce-403b-85c1-216812888760" alt=""><figcaption></figcaption></figure></div>

3\. **Enter** the name of your account, the Shopify store, your account email and account password

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FlxBPLenKLZKcf4dWVuBy%2Fimage.png?alt=media&#x26;token=7aa2c4fa-5f18-40f9-ab3f-31a8adf86ca3" alt=""><figcaption></figcaption></figure>

***

### **IMAP Overview**  <a href="#h_fea44d7fbf" id="h_fea44d7fbf"></a>

**This is optional depending on the Shopify site, not all sites require IMAP to be used.**

* Add an IMAP session
* Connect your email provider
* Select it in your Shopify task under **IMAP Session**

Follow your [IMAP guide](https://guides.stellaraio.com/stellar/navigating-stellaraio/what-is-the-identities-tab/imap-overview) to:

* Faster logins
* Smoother password resets
* Less manual code entry

IMAP lets Stellar read verification codes sent by the Shopify site automatically.

***

### **Task Overview**

### **Normal Mode**

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FQfT0OTTXl2yRm5S0gdnG%2Fimage.png?alt=media&#x26;token=ebc7824c-0434-4bd3-b61e-a03f4696d0c4" alt=""><figcaption></figcaption></figure>

### **Preload Mode**

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2F7Agd6qk6W6C1GRSv4Kd6%2Fimage.png?alt=media&#x26;token=e99e7be0-4d78-4f15-a848-d9e01bd2732e" alt=""><figcaption></figcaption></figure>

### Raffle Mode

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2FWBxYJFEVIMBnIaRNAAp9%2Fimage.png?alt=media&#x26;token=6cdca6fc-983a-473f-ab20-c5993a544ce0" alt=""><figcaption></figcaption></figure>

* What **Mode** do I use?
  * **Normal mode** is to be used only if theres a password page
  * **Preload mode** is to be used for all non-password drops and restocks
  * **Raffle mode** is to be used for raffles releases
* What does **Profile** mean?
  * Select a **Profile** you want to use and that profile information will be used when checking out items
* What type of **Proxies** should I use?
  * Due to recent site changes, it is recommended to prioritize residential proxies, as most ISP proxies are currently banned. ISP proxies may still be used as a backup option for testing performance during a drop.
    * If you're looking for proxies, check out [Stella Proxies](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/proxies) for high quality ISP and Residential proxies&#x20;
* What is **Input**?
  * You can enter the **Product URL,** **Keywords** or **Variants**
    * **Product URL** is the entire URL you see at the top of the product page. For example <https://kith.com/collections/mens-footwear/products/nkbq6806-117>
    * **Keywords** are a way for the bot to pick up and checkout the item you would like. Find the name of the product and make keywords off of that. The keyword format is +Positive,-Negative. For example **+Jordan,+High,+Retro,-Shirt,-Pants,-Socks,-Hat**
      * Important note: Keywords are monitoring/checking the last 50 items
    * **Variants** are another way to identify a product and are often provided from your [cookgroup](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/cook-groups)
  * Multicart feature allows you to purchase multiple products from one site in the same order. This allows you to save on shipping costs. You can use this feature by clicking on the + sign to add a new product line or click the trash can icon to delete a product line
    * This Input field can be live edited (edited while tasks are running without needing to stop and restart tasks)

<figure><img src="https://1122101074-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQL0BOlyqRRf7zyNKSf%2Fuploads%2F88Gnl7gQFnxANI0p4S9N%2Fmulticartex.PNG?alt=media&#x26;token=96d28b4a-6238-4e6e-b091-5c300f0d65d4" alt=""><figcaption></figcaption></figure>

* What is **Raffle ID**?
  * These are provided by your [cookgroup](https://guides.stellaraio.com/stellar/getting-started-with-stellaraio/cook-groups)
* What is **Color (Supreme)?**
  * Add the color of the product you want to purchase using `+color,-color` format. Seperate the colors using only a comma, no spaces.&#x20;
    * For example `+black,-white,-red,-blue`
      * This Color field can be live edited (edited while tasks are running without needing to stop and restart tasks)
* What **Delays** should I use?
  * Be careful with your delays, websites with any proxy protection will ban your proxies fast. Use a wide variety of delays between 4000-8000
    * To edit delays without stopping the task you can use the mass edit button
      * This Delay field can be live edited (edited while tasks are running without needing to stop and restart tasks)
* What is **Size**?
  * Select the **Size** of the product you're trying to checkout
    * You can use a custom size by typing in what you want to use instead of selecting a drop-down option and press enter
      * This Size field can be live edited (edited while tasks are running without needing to stop and restart tasks)
* What is **Site**?
  * Select the **Site** you're trying to bot from the dropdown options
    * Follow [these steps](#adding-a-custom-shopify-site) to add a Shopify Site that's not in the default dropdown options
* What is **Product Quantity**?
  * The amount of the product you are wanting to be in the cart at checkout. If left blank, then it is 1
* What is **Account**?
  * If you would like to checkout on an account you can select which account here. Leave this option blank for guest checkout
* What is **Password**?
  * Some Shopify sites enable a password page which requires a password to enter the site. If you are using StellarAIO on one of these sites, make sure to click this checkbox and enter the password
* What is **Discount Code**?
  * If you would like to use a discount code during checkout, click this checkbox and input the discount code
* What is **Add Mattel RLC Membership?** box?
  * Only check this box if you want to add and purchase RLC Membership. This checkbox is useful for RLC Membership exclusive releases if your Mattel accounts don't already have RLC Membership on them
  * This checkbox will appear when `Creation Mattel` is selected in the Site field
* What is **Price Check?** box?
  * If you check this box, a new field will appear, input the price range. The price you enter is being checked before adding to cart. For example, `5-10` if the price range is $5 to $10
