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

# Import checkout profiles from a CSV or JSON

> Import Kova checkout profiles from AYCD-style or generic CSV/JSON exports. Preview first, then confirm. Supports account-based and guest imports with duplicate handling.

Kova lets you import checkout profiles from external files instead of creating them one by one. The importer works in preview mode first: nothing is written until you review the results and confirm.

## Supported file types and limits

You can import from the following formats:

* **Profile exports**: AYCD-style CSV or JSON, or generic CSV/JSON
* **Account lists**: AYCD Account Task CSV or JSON, or plain text in the format `email:password`

Each file must be **2 MB** or smaller and contain **500 rows** or fewer.

<Note>
  The generic parser recognizes common aliases such as email, shipping, billing, name, phone, state, ZIP/postal, card number, expiration, and CVV.

  Two-digit expiration years are normalized to four digits. US state names are normalized to abbreviations where possible.
</Note>

## Account-based retailer imports

For Target, Walmart, Costco, and Sam's Club, every profile needs three things:

1. A **profile export file** with identity and payment data
2. An **account list file** with a valid email and password for each profile
3. **One enabled IMAP account** assigned to every profile in that import

Profiles are matched to account rows by **normalized email**. Unmatched profiles are marked **invalid** in the preview. Account rows that are not matched to a profile are still counted in the preview but do not create profiles on their own.

## Pokemon Center imports

Pokemon Center is a guest-checkout retailer. You only need a **profile export file**. The importer intentionally discards any retailer-account passwords it finds, because Pokemon Center does not use stored account logins.

## Preview and duplicate handling

During preview, each row is labeled as one of the following:

* **Ready** — valid and unique
* **Invalid** — has a validation problem, such as a missing required field
* **Duplicate** — matches an existing profile or another row in the same file

Duplicates are defined by matching **normalized email, first name, last name, street address, and ZIP code**.

You can choose one of two duplicate modes:

* **Skip duplicates** — keep the existing profile and ignore the duplicate row
* **Update duplicates** — replace the existing profile with the imported values

<Warning>
  Repeated duplicates within the same file are always skipped. Only the first matching row within a single import file is considered for processing; later duplicates are ignored.
</Warning>

## Security

Card numbers, CVVs, and account passwords are encrypted before they are saved. They are **never** exposed in the preview, in activity logs, or in export files.

<Warning>
  Nothing is written to your workspace until you review the preview and click **Confirm Import**.
</Warning>
