> 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/accounts.md).

# Accounts

The Accounts tab in the left sidebar holds every site account the bot uses. It opens on your account groups, with **All accounts** as the default group.

<figure><img src="/files/pEiswjExoum0tpvWxM6u" alt="The Accounts tab showing account groups"><figcaption><p>The Accounts tab opens on your groups. All accounts is the default.</p></figcaption></figure>

## The toolbar

Inside a group, the toolbar buttons from left to right:

* **+** adds accounts.
* The **pencil** edits the selected account.
* The **delete** button deletes the selected accounts.
* The **lock** logs into the selected accounts. This is for Amazon only; every other site logs in through tasks.
* The **last button** clears sessions on the selected accounts, forcing a fresh login the next time tasks start.
* The dropdown on the right filters the list by site.

<figure><img src="/files/YWA062ayycSpSepIoMRb" alt="The accounts toolbar buttons" width="500"><figcaption><p>Left to right: add, edit, delete, login (Amazon only), clear sessions, site filter.</p></figcaption></figure>

## Add accounts

{% stepper %}
{% step %}

#### Open Create Account

Click the **+** button. The window has two input modes: **Default** and **Mass Input**.
{% endstep %}

{% step %}

#### Default: one account at a time

Choose the **Site**, then enter the **Login** (email) and **Password**.

<figure><img src="/files/nQafHsHmAoJQciTaGteJ" alt="The Create Account window on the Default tab" width="450"><figcaption></figcaption></figure>
{% endstep %}

{% step %}

#### Mass Input: many at once

Switch to **Mass Input**, choose the **Site**, and paste one account per line in this format:

```
login:password
```

You can optionally append a proxy and a 2FA secret with semicolons: `login:password;proxy;secret`. Most users only need `login:password`.

<figure><img src="/files/AHLVNVRIIi2YuYOn8yaJ" alt="The Create Account window on the Mass Input tab" width="450"><figcaption><p>One account per line. Only login:password is required.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Leave the proxy options alone

Skip the Proxy List / Input Proxy options and click **Create Account**.
{% endstep %}
{% endstepper %}

{% hint style="warning" %}
**Do not assign proxies to accounts.** Leave the account proxy options untouched for every site and let your tasks handle proxies through the task proxy list. Only set an account proxy if you know exactly what you are doing.
{% endhint %}

For completeness, here is what an account proxy actually does if you do set one: the bot uses that proxy to log into the account. And on sites that have the **Use Account Proxy** toggle in task creation, enabling it makes the task use the account's proxy for every step, not just login. Neither is recommended for normal setups.

## Account groups

Groups make it easy to select many accounts at once during task creation.

{% stepper %}
{% step %}

#### Create the group

On the Accounts tab, click the **folder +** (Create Group) button in the top right.
{% endstep %}

{% step %}

#### Name it and pick a color

Give the group a name and pick a color so it is easy to spot.

<figure><img src="/files/HKFJg1nmz2FXL3fXLtsX" alt="The Create Account Group window" width="480"><figcaption><p>Name it, pick a color, tick the accounts.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Add the accounts

Tick the accounts you want in the group, then click **Create Group**. You can also add accounts later: select them in All accounts with Ctrl+Click or Shift+Click, right-click, and add to group.
{% endstep %}
{% endstepper %}

## Import and export accounts

The two file buttons import and export accounts.

* **Import** only accepts files exported by Refract. We do not support CSV imports from AYCD or any other tool.
* **Export** writes accounts in Refract's proprietary format. The **Include Sessions (Encrypted)** toggle controls what you get: with sessions on, the export is an encrypted file that carries your accounts and their existing sessions, which is how you move accounts to another instance without re-logging in. With sessions off, accounts are written to a plaintext `.txt` file.

<figure><img src="/files/6LUZuBiDuqiZHD6vd8DR" alt="The Export Accounts window with the Include Sessions toggle" width="420"><figcaption><p>Include Sessions on: encrypted file with sessions. Off: plaintext .txt.</p></figcaption></figure>

{% hint style="info" %}
**Moving your whole setup to a new device?** Use App Data export/import in Settings instead. It carries everything, not just accounts. See [Settings](/general-setup/settings.md#move-everything-to-a-new-device).
{% endhint %}

## Logging in

* **Amazon:** accounts must be logged in before tasks can run. Select the accounts, then click the **lock** button.
* **Every other site:** accounts log in through tasks. Start your tasks and the bot handles login. This is why the login button shows "Login via Tasks" for sites like Walmart.

{% hint style="warning" %}
**Seeing "Awaiting task login" in the Status column?** That is what most sites (Walmart, Target, and others) show, and it means exactly what it says: the account logs in by running tasks. Start tasks and the bot does the login flow. Clicking the lock login button will not work for these sites; it is for Amazon only.
{% endhint %}

<figure><img src="/files/78X5zRLWE5zEr9TFjZyV" alt="The Status column showing Awaiting task login" width="190"><figcaption><p>Run tasks to log these in.</p></figcaption></figure>

## Clear a session

To clear an account's saved session, right-click the account and click **Clear Session**. To do many at once, select them and use the clear sessions button on the toolbar. Either way, the account goes through a fresh login the next time tasks start. Re-logging like this can refresh flagged session data, so it comes up in troubleshooting, for example with Walmart 456s.

## FAQ

<details>

<summary>Does Refract use account or profile data at checkout?</summary>

If there is no profile input (Amazon only), Refract uses the account's data. If there is a profile input (most sites), Refract uses the profile info only. If a matching address is already on the account, it skips re-adding it to avoid stacking the same address over and over.

</details>

<details>

<summary>Can my account affect site anti-bots like Shape on Target?</summary>

No. Your account does not affect anti-bot systems like Shape.

</details>

<details>

<summary>What does "account does not exist" mean?</summary>

There is no valid account in Refract for the site you are running. Make sure you created an account entry matching the exact site and credentials.

</details>

<details>

<summary>Why do my passwords get reset on sites like Best Buy?</summary>

Password resets are a normal occurrence on sites like Best Buy. With Reset Invalid Password enabled on your tasks, the bot resets and stores the new password automatically.

</details>

<details>

<summary>Do I need to set a proxy or proxy list on my accounts?</summary>

No. Do not assign proxies directly to accounts for any site. Tasks handle proxies through the task proxy list.

</details>


---

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