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

# Profiles

Profiles live in the **Billing** tab (the wallet icon) in the left sidebar. A profile is the shipping address, billing address, and payment card a task uses to check out. All profiles are stored locally and securely on your machine.

The tab opens on your profile groups, with **All profiles** as the default group.

<figure><img src="/files/oMfkk7S9k9fb8Iix1sWJ" alt="The Billing tab showing profile groups"><figcaption><p>The Billing tab opens on your profile groups.</p></figcaption></figure>

## Create a profile

Click the **+** button to open **Create Profile**. It has three tabs, and every field is required except where noted.

{% stepper %}
{% step %}

#### General

* **Profile Name:** any name that helps you identify it during task creation (e.g. `Visa-Denver-Joe`).
* **Email:** the email for this profile. We recommend a unique email per profile.
* **Cardholder Name:** ideally the name on the card.
* **Card Number**, **CVV** (3 digits for most cards, 4 on the front for Amex), and **Month/Year Exp.**
* **One Time Use:** with this on, the profile checks out only once per site per product. After a success, the bot prevents further checkouts with that profile on that site and product until the bot is restarted.

<figure><img src="/files/T4y1xhSY1WMp3YCVNuVQ" alt="Create Profile on the General tab" width="480"><figcaption><p>Every General field is required.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Shipping

First name, last name, address, city, phone, country, province/state, and postal code are all required. **Address 2** (apartment, suite, unit) is the only optional field.

Format matters: use the correct phone format for the country, and include any spaces the postal format expects.

<figure><img src="/files/jaduJt0LBAuosCxXsYHV" alt="Create Profile on the Shipping tab" width="450"><figcaption><p>Address 2 is the only optional field.</p></figcaption></figure>
{% endstep %}

{% step %}

#### Billing

If the billing address matches shipping, leave **Same As Shipping** on. Otherwise toggle it off and enter the billing address that matches the card issuer's records.
{% endstep %}

{% step %}

#### Create

Click **Create**. The profile appears in your list, ready to select during task creation.
{% endstep %}
{% endstepper %}

## Profile groups

Groups let you select many profiles at once during task creation. Click the **folder +** (Create Group) button in the top right, name the group, pick a color, tick the profiles you want, and create it. You can also select profiles with Ctrl+Click or Shift+Click and right-click to add them to a group.

## Import and export profiles

There are three file buttons on the toolbar, left to right:

<figure><img src="/files/rMoYVEPvFCEsFYQ8M6wM" alt="The three profile import and export buttons" width="212"><figcaption><p>Left to right: Refract import, CSV import, export.</p></figcaption></figure>

* **Import (Refract format):** imports profile files in Refract format. Third-party tools like AYCD can export profiles in Refract format, and this is the button those files go through.
* **Import CSV:** imports profiles from a CSV file. Your CSV must follow our template: [profile CSV template](https://docs.google.com/spreadsheets/d/1aNVMSlX5pbZj-hdrDbQ2zWJUkHM4KC6cmtXt9-ofLFE/edit?usp=sharing).
* **Export:** exports your profiles in Refract format.

## Updating a profile

The bot always uses the current profile info. If you edit a profile, or re-import an updated one (from AYCD or CSV), tasks using that profile check out with the new details. No extra steps needed.

On account sites like Target and Walmart, the bot also updates the account itself when tasks run: it deletes the old address on the account and adds the new one from the profile. You do not need to clean up old addresses on the site manually.

## Error: "Invalid Address Details"

Invalid Address Details means the site is rejecting the profile data. Common reasons:

* Required fields are missing or incorrectly formatted (wrong postal format, missing state selection).
* The billing address does not match the card issuer's records.
* Address components are in the wrong fields (apartment in Address 1 when the site expects it in Address 2).
* Country or state selected incorrectly.

**How to fix it:**

1. Re-open the profile and verify every required field. Address 2 is the only optional one.
2. Test the address manually on the site. Use the site's suggested format if it offers one, or adjust your jig if blocked.

## FAQ

<details>

<summary>How many profiles do I need?</summary>

Ideally each task uses a unique profile, which reduces cancels and detection risk. So: as many profiles as tasks.

</details>

<details>

<summary>Is there a template for importing profiles?</summary>

Yes. Use the [profile CSV template](https://docs.google.com/spreadsheets/d/1aNVMSlX5pbZj-hdrDbQ2zWJUkHM4KC6cmtXt9-ofLFE/edit?usp=sharing) with the CSV import button. Alternatively, tools like AYCD can export profiles directly in Refract format for the Refract import button.

</details>

<details>

<summary>How should I jig my profiles?</summary>

We do not provide assistance with jigs or profile creation methods. Your cook group is the place for current jigging strategies.

</details>

<details>

<summary>Can my profile affect site anti-bot systems, like Shape on Target?</summary>

No single stored profile turns on a site's anti-bot system. However, repeatedly submitting bad or heavily jigged profiles, or reusing the same card or email across many tasks, can trigger site-side protections and increase cancels and errors (Invalid Address Details, Invalid Card Details, Max Card Attempts Reached).

</details>

<details>

<summary>Can I use the same credit card for multiple profiles?</summary>

Possible but not recommended. Reusing the same card across many profiles causes more cancels, authorization locks, and failures on sites like Walmart because of the repeated authorization attempts. Use unique payment methods when possible.

</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/profiles.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.