> For the complete documentation index, see [llms.txt](https://help.refractbot.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.refractbot.com/general-setup/settings.md).

# Settings

The bot's **Settings** tab has five sections: **General**, **Freebies**, **Harvesters**, **IMAP Logins**, and **2FA Codes**. This page covers General, Freebies, and 2FA Codes. Harvesters and IMAP Logins have their own dedicated guides, linked below.

## General

<figure><img src="/files/iUenXobmIzJpCOyGx5iH" alt="The General tab of bot Settings"><figcaption><p>The General tab: webhooks, checkout sound, confirmation dialogs, app data, and logout.</p></figcaption></figure>

### Webhooks

Add a Discord or Slack webhook to receive notifications from the bot. There are two webhook fields:

* **Checkouts:** receives your success and decline notifications.
* **Notifications:** receives bot alerts that may need your attention, like Shape passing but the product going out of stock, or 3DS payment verification prompts.

Paste the webhook URL into the field, click **Save**, then click **Test** to confirm it posts.

Two toggles control what gets sent:

* **Send declines to webhooks:** with this on, declines post to your webhook alongside successes.
* **Hide checkouts from public log:** keeps your checkouts out of the public checkout log. Note that this is not absolute: certain popular products will always be shown in the public log at our discretion.

<details>

<summary>How to create a Discord webhook</summary>

1. Create your own Discord server by clicking the **+** (Add a Server) icon in Discord and following the prompts.
2. Open your server's **Server Settings** and go to the **Integrations > Webhooks** tab.
3. Click **Create Webhook** (or **New Webhook**), choose the channel it should post to, and copy the webhook URL.
4. Paste that URL into Refract and click **Save**, then **Test**.

</details>

<details>

<summary>How to create a Slack webhook</summary>

1. Create a Slack workspace (or use one you own).
2. From the workspace's app directory, add the **Incoming Webhooks** application.
3. In the app's settings, pick the channel it should post to and click **Authorize**.
4. Click generate in the Webhook URL box, copy the URL, paste it into Refract, and click **Save**, then **Test**.

</details>

### Checkout Sound

With **Play sound on successful checkout** on, the bot plays a sound every time a task checks out. The current sound file is shown on the right.

* **Import** a custom sound (MP3 format).
* **Play** previews the current sound.
* **Reset** returns to the default checkout sound.

### Confirmation Dialogs

If you have dismissed confirmation pop-ups with "Don't ask me again," clicking **Reset All Confirmations** brings them all back.

### App Data

**Export** saves all of your app data, and **Import** loads it into another Refract instance. This is how you move your full setup (settings, accounts, profiles, proxies, task groups, and saved sessions) to a new PC or server.

### Move everything to a new device

We get asked this a lot. Here is the whole process:

{% stepper %}
{% step %}

#### Export on your current device

In **Settings > General > App Data**, click **Export** and save the file.
{% endstep %}

{% step %}

#### Move the file to the new device

Get the exported file onto the new machine however you like: USB drive, cloud storage, or a direct transfer.
{% endstep %}

{% step %}

#### Sign out of the current device

Click **Log Out** at the bottom of Settings, or sign the device out from the dashboard's [Devices tab](/online-dashboard/devices.md). This frees the instance so the new device can use it.
{% endstep %}

{% step %}

#### Sign in on the new device

Install Refract on the new device and log in with your account.
{% endstep %}

{% step %}

#### Import the file

Go to **Settings > General > App Data**, click **Import**, and choose the file you moved over.
{% endstep %}
{% endstepper %}

{% hint style="success" %}
That is everything. Your accounts, profiles, proxies, task groups, and saved sessions are all on the new device. You should not need to re-login accounts unless the sessions have expired.
{% endhint %}

### Logout

**Log Out** logs you out of Refract and deactivates this instance, freeing it up so another device can use it. The signed-in account email is shown here too. If you are chasing a "Max Instance Limit Reached" error, this and the dashboard's Devices tab are the two ways to free an instance:

{% content-ref url="/pages/z6txClvRkkbKTdT51wj5" %}
[Devices](/online-dashboard/devices.md)
{% endcontent-ref %}

## Freebies

The **Freebies** tab holds the ASIN/Keyword Blacklist for Amazon Freebies & Deals.

<figure><img src="/files/3RuI3adh1tFEP99MRz6W" alt="The Freebies tab with the ASIN/Keyword Blacklist"><figcaption><p>Comma-separated ASINs and keywords. Click an entry to remove it.</p></figcaption></figure>

* Add ASINs or keywords you never want checked out again, comma-separated: `ASIN,keyword,ASIN,keyword`.
* Click **Add** to save them to the blacklist.
* Click an existing entry to remove it from the blacklist.

{% content-ref url="/pages/mHZpyCgwxnstfxyscQka" %}
[Amazon Freebies & Deals 101](/modules/amazon/amazon-freebies-and-deals-101.md)
{% endcontent-ref %}

## Harvesters

The **Harvesters** tab is where Target Shape cookie harvesters live. It has a full guide:

{% content-ref url="/pages/EjaxLfBYQeNORImXRI1L" %}
[In-Bot (Shape Generation)](/modules/target/in-bot-shape-generation.md)
{% endcontent-ref %}

## IMAP Logins

The **IMAP Logins** tab connects your email so the bot can auto-submit one-time codes. It has a full guide:

{% content-ref url="/pages/w4FUaY6NY47OY1XicIjy" %}
[IMAP](/misc./imap.md)
{% endcontent-ref %}

## 2FA Codes

Click **Open Window** to manually open the 2FA codes window. It lists every email and task currently waiting on a code, and you can filter by site or recipient.

<figure><img src="/files/fHiqcYlce8mhW0B1tTKb" alt="The 2FA Codes tab with the Open Window button"><figcaption><p>The 2FA Codes tab. Open Window brings up the codes list, filterable by site or recipient.</p></figcaption></figure>

{% hint style="info" %}
**Seeing code requests here does not mean IMAP is broken.** The codes window always shows the emails and tasks that need codes, even when IMAP is connected and submitting them successfully. Use this window when you want to see or enter codes manually.
{% endhint %}


---

# 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://help.refractbot.com/general-setup/settings.md?ask=<question>&goal=<endgoal>
```

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