> ## 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.

# Settings Overview

> Complete guide to all GrabMyGig settings and configuration options

## Settings Categories

GrabMyGig provides comprehensive settings to customize your bot's behavior. Access all settings at [app.grabmygig.com/settings](https://app.grabmygig.com/settings).

<CardGroup cols={2}>
  <Card title="Search Settings" icon="magnifying-glass" href="/settings/search">
    Configure filters for pay, distance, time, items, and stores.
  </Card>

  <Card title="Location Settings" icon="location-dot" href="#location-settings">
    Set your home location for distance calculations.
  </Card>

  <Card title="Cities" icon="city" href="#cities">
    Select which cities/zones you want to receive offers from.
  </Card>

  <Card title="Notifications" icon="bell" href="#notifications">
    Configure Email and Telegram notifications.
  </Card>

  <Card title="Account" icon="user" href="#account">
    Manage your Roadie account connection and subscription.
  </Card>
</CardGroup>

***

## Location Settings

<Info>
  Your home location is used to calculate distances for offers. Make sure this is set accurately for the best results.
</Info>

The Location setting allows you to:

* **Set your home address**: Used as the starting point for distance calculations
* **Update location anytime**: Change your base location as needed
* **Accurate distance filtering**: Ensures the distance filter works correctly based on your actual location

### How to Set Your Location

1. Go to **Settings** → **Location**
2. Enter your home address or use the map to pin your location
3. Save your changes

<Tip>
  Set your location to where you typically start your driving day for the most accurate distance calculations.
</Tip>

***

## Cities

The Cities setting lets you choose which geographic areas the bot should monitor for offers.

### How It Works

* **Select multiple cities**: Choose all the cities/zones where you're willing to accept gigs
* **Zone-based filtering**: Only offers from your selected zones will be considered
* **Easy management**: Add or remove cities anytime

### Best Practices

<Tip>
  Start with cities close to your home location, then expand as you get comfortable with the bot's performance.
</Tip>

<Warning>
  Selecting too many distant cities may result in offers that aren't practical for your schedule.
</Warning>

***

## Notifications

Stay informed about your bot's activity with real-time notifications.

### Notification Channels

| Channel      | Description                                    |
| ------------ | ---------------------------------------------- |
| **Email**    | Receive notifications to your registered email |
| **Telegram** | Instant notifications via Telegram bot         |

### Notification Types

You can receive notifications for:

* ✅ **Accepted Offers**: When the bot successfully grabs a gig
* ❌ **Missed Offers**: When an offer matched but was taken by someone else
* ⚠️ **Bot Status**: When the bot starts, stops, or encounters issues

### Setting Up Telegram Notifications

<Steps>
  <Step title="Get Your Telegram Chat ID">
    Message our Telegram bot to receive your unique Chat ID.
  </Step>

  <Step title="Enter Chat ID">
    Go to **Settings** → **Notifications** and enter your Telegram Chat ID.
  </Step>

  <Step title="Enable Notifications">
    Toggle on the notification types you want to receive.
  </Step>
</Steps>

***

## Account

Manage your Roadie account connection and subscription settings.

### Roadie Account Connection

* **Connection Status**: View if your Roadie account is properly connected
* **Reconnect**: If there are issues, you can reconnect your account
* **Multiple Accounts**: Manage connections for both Roadie and RoadieXD

### Subscription Management

* **Current Plan**: View your active subscription (Weekly or Monthly)
* **Billing**: Manage payment methods and billing history
* **Upgrade/Downgrade**: Switch between plans anytime

<Info>
  Your Roadie credentials are encrypted and securely stored. We never have access to your plain-text password.
</Info>

***

## Quick Navigation

<CardGroup cols={2}>
  <Card title="Search Settings" icon="sliders" href="/settings/search">
    Configure all your search filters in detail.
  </Card>

  <Card title="Quick Start" icon="rocket" href="/quickstart">
    New to GrabMyGig? Start here.
  </Card>
</CardGroup>