> ## Documentation Index
> Fetch the complete documentation index at: https://docs.grabmygig.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Search Settings

> Configure filters to only accept gigs that match your criteria

Search Settings are the core of GrabMyGig's smart filtering system. Configure these settings to ensure the bot only accepts offers that meet your specific requirements.

<Info>
  All search settings work together. An offer must match **ALL** your criteria to be accepted.
</Info>

***

## Gig Type

Select which platform(s) you want the bot to monitor.

<Frame>
  <img src="https://mintcdn.com/grabmygig/JoVmNBHctRQz5r5w/images/settings/search/gig_type.png?fit=max&auto=format&n=JoVmNBHctRQz5r5w&q=85&s=46cf97f9e230c1f1bc82f019b71df37c" alt="Gig Type Setting" width="681" height="194" data-path="images/settings/search/gig_type.png" />
</Frame>

| Option       | Description                              |
| ------------ | ---------------------------------------- |
| **Roadie**   | Monitor standard Roadie delivery offers  |
| **RoadieXD** | Monitor RoadieXD (extra delivery) offers |
| **Both**     | Monitor offers from both platforms       |

<Tip>
  If you're new, start with standard Roadie offers to get familiar with how the bot works.
</Tip>

***

## Pay Settings

Configure minimum pay requirements to ensure you only accept profitable gigs.

### Minimum Pay

<Frame>
  <img src="https://mintcdn.com/grabmygig/JoVmNBHctRQz5r5w/images/settings/search/pay.png?fit=max&auto=format&n=JoVmNBHctRQz5r5w&q=85&s=86797255203b771b04806531ac210e02" alt="Pay Setting" width="677" height="340" data-path="images/settings/search/pay.png" />
</Frame>

Set the minimum dollar amount you want to receive per gig. Offers below this amount will be automatically rejected.

**Example**: If you set minimum pay to \*\*$25**, the bot will ignore any offer paying less than $25.

### Pay Per Mile / Pay Per Hour

<Frame>
  <img src="https://mintcdn.com/grabmygig/JoVmNBHctRQz5r5w/images/settings/search/pay-both.png?fit=max&auto=format&n=JoVmNBHctRQz5r5w&q=85&s=4a06d65fea29bb445038e043aa5e7eb9" alt="Pay Both Setting" width="674" height="268" data-path="images/settings/search/pay-both.png" />
</Frame>

For more advanced filtering, you can set:

| Filter          | Description                    | Recommended   |
| --------------- | ------------------------------ | ------------- |
| **Min \$/Mile** | Minimum pay per mile driven    | $1.50 - $2.00 |
| **Min \$/Hour** | Minimum pay per estimated hour | $20 - $30     |

<Warning>
  Setting these values too high may result in fewer accepted offers. Start conservative and adjust based on your market.
</Warning>

***

## Distance and Time

Control how far you're willing to drive and how long deliveries should take.

<Frame>
  <img src="https://mintcdn.com/grabmygig/JoVmNBHctRQz5r5w/images/settings/search/distance-and-time.png?fit=max&auto=format&n=JoVmNBHctRQz5r5w&q=85&s=3c9ca614e8bd5211556d203982ba6532" alt="Distance and Time Setting" width="677" height="431" data-path="images/settings/search/distance-and-time.png" />
</Frame>

### Distance Settings

| Setting                 | Description                                             |
| ----------------------- | ------------------------------------------------------- |
| **Max Pickup Distance** | Maximum distance from your location to the pickup point |
| **Max Total Distance**  | Maximum total distance for the entire delivery          |

### Time Settings

| Setting               | Description                      |
| --------------------- | -------------------------------- |
| **Min Delivery Time** | Minimum time window for delivery |
| **Max Delivery Time** | Maximum time window for delivery |

<Tip>
  Consider your local traffic patterns when setting distance limits. A 10-mile drive in rush hour may take longer than a 15-mile drive at off-peak times.
</Tip>

***

## Item Count

Filter offers based on the number of items in the delivery.

<Frame>
  <img src="https://mintcdn.com/grabmygig/JoVmNBHctRQz5r5w/images/settings/search/item.png?fit=max&auto=format&n=JoVmNBHctRQz5r5w&q=85&s=9c0681b93edd8f52a554ea4021e86b5a" alt="Item Setting" width="666" height="360" data-path="images/settings/search/item.png" />
</Frame>

| Setting       | Description                                       |
| ------------- | ------------------------------------------------- |
| **Min Items** | Minimum number of items you're willing to deliver |
| **Max Items** | Maximum number of items you're willing to deliver |

<Info>
  Fewer items typically mean faster pickups and deliveries. However, multi-item orders often pay more.
</Info>

***

## Store Filters

Control which stores you want to pick up from.

### Include Stores

<Frame>
  <img src="https://mintcdn.com/grabmygig/JoVmNBHctRQz5r5w/images/settings/search/store-include.png?fit=max&auto=format&n=JoVmNBHctRQz5r5w&q=85&s=38a29aa05db8c1eece2a433396e46b6e" alt="Store Include Setting" width="675" height="355" data-path="images/settings/search/store-include.png" />
</Frame>

When you **include** stores, the bot will **ONLY** accept offers from these specific stores.

**Use case**: You know certain stores have efficient pickup processes or consistently good-paying orders.

### Exclude Stores

<Frame>
  <img src="https://mintcdn.com/grabmygig/JoVmNBHctRQz5r5w/images/settings/search/store-exclude.png?fit=max&auto=format&n=JoVmNBHctRQz5r5w&q=85&s=fd092487a356048b972c539d651da12e" alt="Store Exclude Setting" width="682" height="351" data-path="images/settings/search/store-exclude.png" />
</Frame>

When you **exclude** stores, the bot will **NEVER** accept offers from these stores.

**Use case**: Avoid stores with long wait times, difficult parking, or consistently low-paying orders.

<Warning>
  You can use either Include OR Exclude mode, but not both at the same time.
</Warning>

***

## Refresh Rate

Control how frequently the bot checks for new offers.

<Frame>
  <img src="https://mintcdn.com/grabmygig/JoVmNBHctRQz5r5w/images/settings/search/refresh_rate.png?fit=max&auto=format&n=JoVmNBHctRQz5r5w&q=85&s=025ad1f74779770c0487cb597dae71f5" alt="Refresh Rate Setting" width="673" height="200" data-path="images/settings/search/refresh_rate.png" />
</Frame>

| Setting    | Description                 | Best For                         |
| ---------- | --------------------------- | -------------------------------- |
| **Fast**   | Checks every few seconds    | Peak hours, competitive markets  |
| **Normal** | Balanced checking frequency | General use                      |
| **Slow**   | Less frequent checks        | Off-peak hours, saving resources |

<Tip>
  Use faster refresh rates during peak hours (6-9 AM, 11 AM-1 PM, 5-8 PM) to catch high-demand offers quickly.
</Tip>

***

## Stop Condition

Configure when the bot should automatically stop accepting offers.

<Frame>
  <img src="https://mintcdn.com/grabmygig/JoVmNBHctRQz5r5w/images/settings/search/stop_condition.png?fit=max&auto=format&n=JoVmNBHctRQz5r5w&q=85&s=56affbb9151de01aff698dc75299487f" alt="Stop Condition Setting" width="671" height="271" data-path="images/settings/search/stop_condition.png" />
</Frame>

### Available Stop Conditions

| Condition            | Description                                      |
| -------------------- | ------------------------------------------------ |
| **After X Offers**   | Stop after accepting a specific number of offers |
| **After X Earnings** | Stop after reaching a target earnings amount     |
| **At Specific Time** | Stop at a scheduled time                         |
| **Never**            | Keep running until manually stopped              |

<Info>
  Stop conditions help you manage your workload and avoid over-committing. Set realistic limits based on how many gigs you can actually complete.
</Info>

***

## Recommended Settings by Driver Type

<AccordionGroup>
  <Accordion title="Part-Time Driver" icon="clock">
    * **Min Pay**: \$20-25
    * **Max Distance**: 10-15 miles
    * **Stop Condition**: After 3-5 offers
    * **Refresh Rate**: Normal
  </Accordion>

  <Accordion title="Full-Time Driver" icon="truck">
    * **Min Pay**: \$15-20
    * **Max Distance**: 20-25 miles
    * **Stop Condition**: After \$150-200 earnings
    * **Refresh Rate**: Fast during peak hours
  </Accordion>

  <Accordion title="Weekend Warrior" icon="calendar-week">
    * **Min Pay**: \$25-30 (higher standards for limited time)
    * **Max Distance**: 15-20 miles
    * **Stop Condition**: At specific end time
    * **Refresh Rate**: Fast
  </Accordion>
</AccordionGroup>

***

## Next Steps

<CardGroup cols={2}>
  <Card title="Settings Overview" icon="gear" href="/settings/overview">
    Learn about other settings like Location, Cities, and Notifications.
  </Card>

  <Card title="Quick Start" icon="rocket" href="/quickstart">
    New to GrabMyGig? Start with our quick setup guide.
  </Card>
</CardGroup>
