> For the complete documentation index, see [llms.txt](https://guides.stellaraio.com/stellar/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://guides.stellaraio.com/stellar/retailers/shopify.md). # Shopify Complete guide on our Shopify module
The Shopify module supports guest and account-based checkout across default and custom Shopify stores. Shopify stores can behave very differently. Some use password pages, product queues, accounts, raffles, checkpoints, or additional checkout protection. Always test the exact store you plan to run before an important release. *** ## Video Guide {% embed url="" %} *** ## Quick Start: Recommended Setup This section provides the standard recommended setup for most Shopify releases. Individual Shopify stores may behave differently, so always follow newer store-specific or drop-specific instructions when provided. #### 1. Prepare Your Setup Before creating tasks: * Update StellarAIO to the latest version. * Create profiles with valid billing, shipping, and payment information. * Prepare high-quality residential proxies. * Use multiple proxy providers or proxy pools when possible. * Prepare Captcha Harvesters if the store is expected to use captchas. * Obtain the product URL, variant ID, keywords, or Raffle ID. * Confirm the desired sizes and product quantity. * Test the store with an in-stock product when possible. Residential proxies are recommended for most Shopify stores. ISP proxies may work on some stores, but they should be tested before an important release. #### 2. Add the Shopify Store If the store is not already available in the task’s **Site** dropdown: 1. Open **Settings**. 2. Select **Shopify**. 3. Select **Add Shopify Store**. 4. Enter a recognizable store name. 5. Enter the store’s main domain. 6. Save the store. Use the store’s main domain, not a product URL. Example: ``` https://example.com ``` #### 3. Add a Shopify Session When Required A Shopify session is only required when the store requires an account. For guest checkout, leave the **Session** field blank when the store permits it. To add a session: 1. Open **Identities → Sessions**. 2. Select **Shopify**. 3. Create or select a session group. 4. Select **Add Session**. 5. Select the correct Shopify store. 6. Enter the account email and password when required. 7. Save the session. The store selected on the session must match the **Site** selected on the task. Select an IMAP session only when the store sends login or verification codes by email. #### 4. Choose the Correct Mode Use **Preload** for most Shopify drops and restocks that do not have a password page. This is the recommended starting mode for most releases. Use **Normal** when the storefront has an active password page and a storefront password will be required. Use **Raffle** only for supported raffle releases when you have the correct Raffle ID. #### 5. Create the Task For most standard drops and restocks, create a **Preload** task with: * **Profile:** Your valid checkout profile * **Monitor Proxy:** High-quality residential proxy group * **Checkout Proxy:** High-quality residential proxy group * **Input:** Product URL, variant ID, or properly formatted keywords * **Sizes:** Your desired sizes * **Delay:** Start around `4000–8000` * **Site:** The correct Shopify store * **Product Quantity:** `1` * **Session:** Leave blank for guest checkout, or select the matching store session * **IMAP Session:** Select only when email verification is required * **Captcha Provider:** Prepare the selected solving option * **Endless Mode:** Leave disabled unless you intentionally want repeat checkout attempts For a password-page release, use the same general setup with **Normal** mode, enable **Use Password**, and enter the exact storefront password. The storefront password is different from a Shopify account password. #### 6. Choose the Best Product Input Use product information in this order when available: 1. Direct product URL 2. Variant ID 3. Keywords A direct URL is usually the most accurate option. Keyword format: ``` +positive,+positive,-negative,-negative ``` Example: ``` +Jordan,+High,+Retro,-Shirt,-Pants ``` Shopify keyword monitoring checks only the most recent products available to the module. Use a direct product URL or variant whenever possible. #### 7. Start and Check Your Tasks For most scheduled Shopify drops: 1. Start tasks approximately 5–10 minutes before the expected release. 2. Confirm that tasks are monitoring successfully. 3. Confirm that your proxies are working. 4. Open Captcha Harvesters when captchas are expected. 5. Keep tasks running through additional stock waves. For password-page releases, create and start Normal tasks early enough to confirm that they are waiting correctly. For random restocks, use Preload mode with sustainable delays and monitor your residential proxy data usage. Setting a **Start Time** does not automatically start a task. You must still manually start the task in Stellar. #### 8. Recommended Scale Start with approximately: ``` 1–3 tasks per profile ``` Scale according to: * The selected Shopify store * Number of profiles * Proxy quality and available residential data * Captcha-solving capacity * Computer or server resources * Store limits * Current drop instructions More tasks do not automatically improve results. Excessive task counts can increase proxy bans, captchas, rate limits, and duplicate checkout attempts. *** ## **Preliminary Checklist** Before creating Shopify tasks, confirm that you have: * [ ] Updated StellarAIO to the latest version. * [ ] Created profiles with valid billing, shipping, and payment information. * [ ] Added high-quality residential proxies. * [ ] Prepared ISP proxies as an additional or backup option. * [ ] Added multiple proxy providers or proxy pools when possible. * [ ] Added the Shopify store under Settings if it is not already listed. * [ ] Added a Shopify session if the store requires an account. * [ ] Prepared an IMAP session if the store sends email verification codes. * [ ] Prepared Captcha Harvesters if the store uses captchas. * [ ] Obtained the product URL, keywords, variant ID, or Raffle ID. * [ ] Confirmed the desired sizes and product quantity. * [ ] Tested the setup on an in-stock product when possible. * [ ] Enabled cook group notifications for drop information and product updates. *** ## Proxy Recommendations Shopify proxy performance varies significantly by store. Residential proxies are currently recommended for the majority of Shopify tasks because many stores block common ISP and datacenter proxy ranges. ISP proxies may still work on certain stores and can be tested as an additional or backup option. Recommended practices: * Use high-quality residential proxies for most tasks. * Test ISP proxies on the specific store before relying on them. * Use multiple proxy providers or pools. * Avoid running every task through one provider. * Rotate or replace proxies that receive repeated bans. * Adjust delays when a store begins rate-limiting requests. Residential proxies consume data while tasks are running, including when they are monitoring for long periods. Monitor your data usage when leaving tasks running. *** ### Adding a Custom Shopify Store If the Shopify store does not appear in the Site dropdown, add it under Settings. 1. Open **Settings**. 2. Select **Shopify**. 3. Select **Add Shopify Store**.
4. Enter a recognizable Shopify Name. 5. Enter the store’s main domain in the Shopify URL field. 6. Select **Add**. Example Shopify Name: ``` Example Store ``` Example Shopify URL: ``` https://example.com ``` Use the store’s main domain. Do not enter a product URL. After saving the store, it will appear in the Site dropdown when creating Shopify tasks.
*** ## Shopify Accounts and Sessions A Shopify session is only required when the selected store requires an account. Leave the Session field blank for guest checkout when the store allows it. #### Adding a Shopify Session 1. Open **Identities**. 2. Open **Sessions**. 3. Select **Shopify**. 4. Create or select a session group. 5. Select **Add Session**. 6. Enter an optional Session Name. 7. Select the correct Shopify Store. 8. Enter the account email. 9. Enter the account password when required. 10. Save the session. The Shopify Store selected on the session must match the store selected on the task. #### Session Name Optional name used to identify the account inside Stellar. Use a recognizable name containing the store or account email. #### Shopify Store Select the store associated with the account. If the store is missing, add it under: ``` Settings → Shopify → Add Shopify Store ``` #### Account Email Enter the email used by the Shopify store account. #### Account Password Enter the account password when the store requires password-based login. Some Shopify accounts use email verification or passwordless login. In those cases, IMAP may also be needed. ### IMAP Sessions IMAP is optional and is not required for every Shopify store. Use IMAP when the store sends login or verification codes by email. Selecting an IMAP session allows Stellar to retrieve supported codes automatically. IMAP can help with: * Account login codes * Email verification * Passwordless login * Reduced manual code entry Select the IMAP session inside the Shopify task when it is required. If multiple store accounts forward their emails to one master Gmail inbox, one Gmail IMAP session can be used to retrieve those forwarded messages. See the IMAP Overview Guide for setup instructions. *** ## Supported Modes Shopify currently has three modes: ### Normal Mode Normal mode is intended for Shopify releases using a password page. Common examples may include Kith, Supreme, and other stores that restrict access before a release. Use Normal mode when: * The storefront has an active password page. * A password will be provided before or during the release. * The task needs to wait for the password page to open. Enable **Use Password** and enter the correct storefront password when one is required. Do not use Normal mode for ordinary non-password restocks. Use Preload mode instead.
### Preload Mode Preload mode is recommended for most non-password Shopify drops and restocks. Use Preload mode when: * The store does not have a password page. * You are monitoring a scheduled product release. * You are monitoring a restock. * You want the task to prepare the checkout flow before the product becomes available. For most Shopify releases, Preload is the recommended starting mode.
### Raffle Mode Raffle mode is used for supported raffle-based releases. Raffle mode uses a simpler set of fields than Normal and Preload. Before creating Raffle tasks, obtain the correct Raffle ID and confirm the raffle’s supported sizes and closing time.
### Normal and Preload Field Breakdown Normal and Preload contain the same primary task fields. The main difference is when each mode should be used. #### Name Optional custom name for the task. Use a name that identifies the store, product, or release. #### Mode Select: * `Normal` for password-page releases. * `Preload` for most non-password drops and restocks. #### Profile Select the profile containing the billing, shipping, and payment information used at checkout. Make sure the profile information is accurate before an important release. #### Monitor Proxy Select the proxy group used while monitoring the store or product. Residential proxies are currently recommended for most Shopify stores. ISP proxies may be tested as an additional option. #### Checkout Proxy Select the proxy group used during the checkout process. Use high-quality proxies. Avoid relying entirely on the same provider or pool for every task. #### Input Input tells Stellar which product to monitor. You can enter: * Product URL * Keywords * Variant ID **Product URL** Use the complete product-page URL. Example: ``` https://example.com/products/product-name ``` Product URLs are generally the most accurate option when the correct page is known. **Keywords** Keywords allow Stellar to identify a product using its title. Use this format: ``` +positive,+positive,-negative,-negative ``` Example: ``` +Jordan,+High,+Retro,-Shirt,-Pants,-Socks ``` Positive keywords must appear in the product title. Negative keywords exclude unwanted products. Shopify keyword monitoring checks only the most recent products available to the module. The current guide limit is the latest 50 products, so use a direct product URL or variant whenever possible. **Variant ID** A variant identifies a specific product option, such as a particular size or color. Variant IDs may be provided by your cook group. Use a variant when you need the task to target a specific product variation directly. #### Multicart Multicart allows one task to attempt to purchase multiple products from the same Shopify store in one order. Select the `+` button beside the product and size area to add another product line. For every line: 1. Enter the product URL, keywords, or variant. 2. Select the desired sizes. 3. Confirm that every product belongs to the same Shopify store. Use the delete option to remove an unwanted product line. Multicart may reduce shipping costs, but adding more products can make checkout more complicated. Test the setup before relying on it during an important release. #### Sizes Select the sizes the task should attempt to purchase. You may select one or multiple sizes. If supported, enter a custom size and confirm it to add it to the size selection. Make sure the size spelling matches the options used by the Shopify store. The Sizes field can be live edited while the task is running. #### Delay Delay controls how frequently the task checks the site or product. The value is entered in milliseconds. Recommended starting range: ``` 4000-8000 ``` Lower delays check more frequently but increase the risk of proxy bans and rate limits. Higher delays are safer but may respond more slowly. Adjust the delay based on: * Selected Shopify store * Proxy quality * Site protection * Length of time the task will run * Current Stellar announcements The Delay field can be live edited or changed through Mass Edit while tasks are running. #### Site Select the Shopify store you want to run. If the store is not listed, add it under: ``` Settings → Shopify ``` The selected Site must match the store associated with the selected Shopify session. #### Product Quantity Enter the quantity of the selected product the task should attempt to add to cart. Recommended starting value: ``` 1 ``` Use a higher quantity only when the store allows it and you intentionally want multiple units. #### IMAP Session Select an IMAP session when the Shopify store sends account login or verification codes by email. Leave this blank when the store does not require email verification. #### Start Time Optional scheduled time at which an already-started task may begin operating. Setting a Start Time does not start the task automatically. You must still start the task in Stellar. #### End Time Optional time at which the task should stop operating. #### Session Select the Shopify account used by the task. The session must be configured for the same Shopify store selected in the Site field. Leave Session blank for guest checkout when the store allows it. #### Password Enable **Use Password** when the Shopify store has a password-protected storefront. After enabling it, enter the exact storefront password. This is not the Shopify account password. It is the password used to enter the protected storefront. Use this primarily with Normal mode. #### Discount Code Enable **Use Discount Code** when you want Stellar to apply a discount code during checkout. After enabling it, enter the exact code. Discount codes can expire, have product restrictions, or become invalid during a release. Confirm the code before running important tasks. #### Price Check Enable **Use Price Check** to restrict checkout to an expected price range. Enter the minimum and maximum price using this format: ``` 5-10 ``` This example allows a product priced between $5 and $10. Price Check can help prevent an unintended checkout when using broad keywords. #### Captcha Provider Select the captcha-solving option the task should use when the Shopify store presents a captcha. Prepare your selected provider before starting tasks. The in-bot captcha solution is generally recommended when supported. Shopify stores may present: * Checkpoint captchas * Login captchas * Checkout captchas * Multiple captchas during one release Open your Captcha Harvesters before a captcha-heavy drop. Only create as many harvesters as your computer or server can handle reliably. #### Endless Mode Endless Mode allows a task to restart after a successful checkout. Only enable this when you intentionally want the task to continue attempting additional checkouts. #### Endless Limit Sets the maximum number of successful checkouts allowed when Endless Mode is enabled. Enter an order limit to prevent unintended repeat purchases. #### Task Qty Controls how many copies of the configured task Stellar creates. This is different from Product Quantity: * Product Quantity controls how many units the task attempts to purchase. * Task Qty controls how many separate tasks are created. ### Raffle Mode Field Breakdown #### Name Optional custom name for the raffle task. #### Mode Select: ``` Raffle ``` #### Profile Select the profile containing the information used for the raffle entry. #### Checkout Proxy Select the proxy group used to submit the raffle entry. Use high-quality proxies and avoid submitting excessive entries through the same proxy. #### URL Optional raffle or product URL. Enter the URL when it is provided for the raffle. The Raffle ID remains the required raffle identifier. #### Raffle ID Enter the Raffle ID for the release. Raffle IDs are commonly provided by your cook group or the latest Stellar drop instructions. Confirm that the ID belongs to the correct store and release. #### Size Select the size for the raffle entry. Raffle mode accepts one selected size per task. Create separate tasks when you intentionally need different size selections. #### Delay Enter the task delay in milliseconds. Use the current retailer or drop recommendation when one is provided. #### Site Select the Shopify store hosting the raffle. If the store is missing, add it under Settings → Shopify. #### Start Time Optional time at which an already-started raffle task may begin operating. #### End Time Optional time at which the raffle task should stop. Use End Time carefully so the task does not stop before the raffle entry is completed. #### Task Qty Controls how many raffle tasks are created. Follow the store’s rules and avoid creating unintended duplicate entries. ### When to Start Tasks #### Scheduled Drops For most scheduled Shopify drops: * Start tasks approximately 5–10 minutes before the expected release. * Confirm that tasks are monitoring successfully. * Confirm that the selected proxies are working. * Open Captcha Harvesters when captchas are expected. * Keep tasks running through additional stock waves. #### Password-Page Drops For password-protected releases: * Use Normal mode. * Create tasks before the release. * Enable **Use Password**. * Enter the storefront password when it becomes available. * Start tasks early enough to confirm that they are waiting correctly. * Keep Captcha Harvesters ready. #### Random Restocks For random restocks: * Use Preload mode. * Leave tasks running when appropriate. * Use sustainable delays. * Monitor residential proxy data usage. * Live edit the Input or Delay if updated information becomes available. #### Raffles Start Raffle tasks before the entry window closes. Do not wait until the final minute, because a proxy failure, captcha, or verification request may delay the submission. Setting a Start Time does not automatically start a task. You must still manually start the task in Stellar. ### How Many Tasks? Recommended starting point: ``` 1-3 tasks per profile ``` Scale based on: * Number of profiles * Selected Shopify store * Proxy quality * Available residential data * Captcha-solving capacity * Computer or server resources * Store limits * Drop instructions More tasks do not automatically improve results. Excessive tasks can increase proxy bans, captchas, rate limits, and duplicate checkout attempts. ### Captcha Strategy Some Shopify stores are captcha-heavy, especially during high-demand releases. Recommended preparation: * Create Captcha Harvesters before the drop. * Open harvesters before they are urgently needed. * Use the in-bot captcha solution when recommended. * Enable Auto Click where appropriate. * Test Local AI if you are using Local AI solving. * Be prepared to solve captchas manually when necessary. * Do not create more harvesters than your device can handle reliably. * Expect that some stores may present more than one captcha. ## Common Errors and Fixes #### Shopify Store Is Missing **Cause:** The store has not been added to Stellar. **Fix:** 1. Open Settings. 2. Select Shopify. 3. Select Add Shopify Store. 4. Enter a name and the store’s main domain. 5. Save the store. 6. Reopen the task creator and select it under Site. #### Task Cannot Find the Product **Cause:** The URL, keywords, variant, or selected Site is incorrect. **Fix:** * Confirm the product URL. * Remove unnecessary URL parameters. * Confirm positive and negative keyword formatting. * Remember that keywords monitor only recent products. * Use a direct URL or variant when available. * Confirm the correct Shopify Site is selected. #### Keywords Find the Wrong Product **Cause:** The keywords are too broad. **Fix:** * Add more positive keywords. * Add negative keywords for unwanted products. * Enable Price Check. * Use the direct product URL when available. #### Waiting for Captcha **Cause:** The task requires a captcha solution. **Fix:** * Confirm the selected Captcha Provider is ready. * Open Captcha Harvesters. * Confirm the harvesters are connected. * Confirm the device can handle the active harvesters. * Be prepared to solve manually if automatic solving does not complete. #### Proxy Banned or Rate Limited **Cause:** The proxy is blocked, the delay is too low, or too many tasks share the same proxy pool. **Fix:** * Test a different residential proxy pool. * Increase the delay. * Spread tasks across multiple providers. * Stop repeatedly restarting blocked tasks. * Confirm the store is accessible through the selected proxy. #### Account Will Not Log In **Cause:** The Shopify session information is incorrect or the store requires email verification. **Fix:** * Confirm the session is assigned to the correct Shopify store. * Confirm the account email. * Confirm the password when required. * Select the correct IMAP session. * Check for an emailed verification code. * Test the account manually. #### Password Page Does Not Open **Cause:** The wrong mode or storefront password is being used. **Fix:** * Use Normal mode. * Enable Use Password. * Enter the exact storefront password. * Confirm that the selected Site is correct. * Confirm the password has not changed. #### Price Check Rejects the Product **Cause:** The detected price is outside the configured range. **Fix:** * Confirm the product price. * Confirm the minimum and maximum values. * Increase the range only if you are comfortable purchasing at the new price. #### Multicart Does Not Work **Cause:** One of the product inputs, sizes, or store selections is incorrect. **Fix:** * Confirm all products belong to the same Shopify store. * Confirm every product line has a valid input. * Confirm the selected sizes exist. * Test the products individually. * Reduce the multicart size if the store limits cart contents. #### Raffle Entry Fails **Cause:** The Raffle ID, Site, size, proxy, or entry window is incorrect. **Fix:** * Confirm the Raffle ID. * Confirm the Shopify Site. * Confirm the selected size. * Test another checkout proxy. * Confirm that the raffle is still open. * Follow the latest drop-specific instructions. #### Endless Mode Does Not Repeat **Cause:** Endless Mode is disabled or the Endless Limit has been reached. **Fix:** * Confirm Endless Mode is enabled. * Confirm an Endless Limit is entered. * Confirm the configured limit has not already been reached. ### Final Reminder Shopify stores differ significantly. A setup that works for one store may not work for another. For the strongest setup: * Use the correct mode. * Use direct product information when available. * Prioritize residential proxies. * Prepare captchas in advance. * Test the selected store. * Use clean profiles and sessions. * Start tasks early enough to verify the setup. * Follow the latest store-specific instructions. --- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## 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, and the optional `goal` query parameter: ``` GET https://guides.stellaraio.com/stellar/retailers/shopify.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. 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.