Skip to main content
The Shopify Module uses a comprehensive configuration object to control all aspects of the checkout process. This guide covers all available configuration options extracted from the source code.

​
Item Configuration Object

The main configuration object structure from Preload.js:42-83: 
let item = {
  shopifyEmail: "",
  shopifyPassword: "",
  color: "",
  delay: 0,
  id: "Sat Aug 08 2020 00:02:51 GMT+0200 (CEST)111",
  url: "https://kith.com/collections/mens-footwear/products/cl20cbr08-bla",
  urltest: "https://kith.com/collections/mens-footwear/products/cl20cbr08-bla",
  keywords: "",
  keywordstest: "",
  profile: { /* ... */ },
  proxyIp: "",
  proxyPort: "",
  proxyUser: "",
  proxyPass: "",
  randomColor: false,
  randomSize: true,
  randomSizetest: true,
  sizetest: "10",
  size: "10",
  website: "www.kith.com",
}

​
Core Settings

​
url
string
required
Direct product URL for the target item. The bot will fetch this product directly.
url: "https://kith.com/collections/mens-footwear/products/cl20cbr08-bla"
​
urltest
string
Test product URL used for preloading the checkout session. Preload.js uses this to generate a valid checkout URL before the real product drops.
urltest: "https://kith.com/collections/mens-footwear/products/test-product"
​
website
string
required
The domain of the Shopify store (without https://).
website: "www.kith.com"
​
delay
number
default:"0"
Delay in milliseconds before submitting payment. Set to 0 for maximum speed.
delay: 0  // No delay
delay: 3000  // 3 second delay
​
id
string
Internal task identifier. Auto-generated, no need to modify.

​
Product Selection

​
keywords
string
Keywords for finding the real product when url is not provided. Supports advanced filtering with + and - syntax (see Advanced Features).
keywords: "+yeezy +350 +boost -toddler"
​
keywordstest
string
Keywords for finding the test product during preload phase.
keywordstest: "+tee"
​
color
string
Product color preference. Used in keyword filtering unless randomColor is enabled.
color: "Black"
​
randomColor
boolean
default:"false"
If true, ignores color preference and selects any available color.
randomColor: false  // Use specified color
randomColor: true   // Any color

​
Size Selection

​
size
string
default:"10"
Target size for the real product. Can be numeric (“10”) or text (“M”, “Large”).
size: "10"      // Shoe size
size: "M"       // Clothing size
size: "OneSize" // One size items
​
sizetest
string
default:"10"
Target size for the test product during preload.
​
randomSize
boolean
default:"true"
If true, randomly selects any available size for the real product.
randomSize: true   // Any available size
randomSize: false  // Use specified size
​
randomSizetest
boolean
default:"true"
Random size selection for test product.

​
Profile Configuration

The profile object contains all checkout information:
​
profile
object
required
Complete billing and shipping information for checkout.

​
Personal Information

​
profile.firstName
string
required
First name for shipping address.
firstName: "Tim"
​
profile.lastName
string
required
Last name for shipping address.
lastName: "Smithson"
​
profile.email
string
required
Email address for order confirmation.
email: "[email protected]"
​
profile.phoneNumber
string
required
Phone number (digits only, no formatting).
phoneNumber: "8455415678"

​
Address Information

​
profile.address
string
required
Street address (line 1).
address: "19 main street"
​
profile.apt
string
Apartment, suite, or unit number (optional).
apt: "Apt 4B"
apt: ""  // Leave empty if not applicable
​
profile.city
string
required
City name.
city: "New York"
​
profile.state
string
State or province code (2 letters for US states).
state: "NY"  // New York
state: "CA"  // California
​
profile.zipCode
string
required
Postal/ZIP code.
zipCode: "10016"
​
profile.country
string
required
Country code (2 letters, ISO 3166-1 alpha-2).
country: "US"  // United States
country: "GB"  // United Kingdom

​
Payment Information

Never commit payment information to version control. Use environment variables or secure configuration management.
​
profile.cardNumber
string
required
Credit card number (no spaces or dashes).
cardNumber: "4242424242424242"
​
profile.nameOnCard
string
required
Full name as it appears on the card.
nameOnCard: "Tim Smithson"
​
profile.cvv
string
required
Card security code (CVV/CVC).
cvv: "123"
​
profile.expirationMonth
number
required
Expiration month (1-12, no leading zero).
expirationMonth: 2   // February
expirationMonth: 12  // December
​
profile.expirationYear
number
required
Expiration year (last 2 digits only). The script automatically prepends “20”.
expirationYear: 22  // Will become 2022
expirationYear: 25  // Will become 2025
​
profile.cardType
string
required
Card brand/type.
cardType: "visa"
cardType: "mastercard"
cardType: "amex"
​
profile.id
string
Internal profile identifier. No need to modify.
​
profile.name
string
Profile name label. Not used in checkout process.
name: "Home"

​
Proxy Configuration

Configure proxy settings to route requests through a proxy server:
proxyIp: "123.45.67.89",
proxyPort: "8080",
proxyUser: "username",
proxyPass: "password"
All four fields must be provided to enable proxy support. The bot automatically constructs the proxy URL:
http://username:[email protected]:8080
​
proxyIp
string
Proxy server IP address.
​
proxyPort
string
Proxy server port number.
​
proxyUser
string
Proxy authentication username.
​
proxyPass
string
Proxy authentication password.

​
Account Login (Optional)

​
shopifyEmail
string
Shopify account email for stores that require login before checkout.
shopifyEmail: "[email protected]"
​
shopifyPassword
string
Shopify account password.
shopifyPassword: "your_password"
Account login is handled automatically when the checkout URL redirects to /account/login. The bot detects this and submits credentials, including handling challenge captchas if required (lines 308-368).

​
Configuration Examples

let item = {
  url: "https://store.com/products/sneaker",
  website: "store.com",
  size: "10",
  randomSize: false,
  delay: 0,  // Maximum speed
  profile: {
    firstName: "John",
    lastName: "Doe",
    email: "[email protected]",
    phoneNumber: "5551234567",
    address: "123 Main St",
    apt: "",
    city: "New York",
    state: "NY",
    zipCode: "10001",
    country: "US",
    cardNumber: "4111111111111111",
    nameOnCard: "John Doe",
    cvv: "123",
    expirationMonth: 12,
    expirationYear: 25,
    cardType: "visa"
  },
  proxyIp: "",
  proxyPort: "",
  proxyUser: "",
  proxyPass: "",
  shopifyEmail: "",
  shopifyPassword: ""
}

​
Next Steps

Script Variants

Learn about Preload.js, fast.js, and safe_1.js variants

Advanced Features

Queue handling, captcha solving, and keyword filtering

Build docs developers (and LLMs) love

Get started for freeTalk to us