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

# Contacts

> Add, import, enrich, subscribe, and inspect the people in your Marketing account.

A contact is one person JetEmail can send marketing email to. The record combines identity, consent status, personalisation data, tags, audience membership, and recent delivery performance.

## Contact fields

| Field                      | Purpose                                                  |
| -------------------------- | -------------------------------------------------------- |
| **Email**                  | Required recipient address                               |
| **First name / last name** | Optional identity fields and built-in merge values       |
| **Status**                 | `subscribed`, `unsubscribed`, `bounced`, or `complained` |
| **Audiences**              | One or more recipient lists; at least one is required    |
| **Custom properties**      | Key/value data available as merge fields                 |
| **Tags**                   | Internal labels for search and organisation              |

## Add one contact

1. Go to **Marketing** → **Contacts**
2. Click **Add contact**
3. Enter the email address and optional name
4. Select at least one audience
5. Add optional tags
6. Add custom property key/value pairs
7. Click **Add contact**

If you do not yet have an audience, create one under **Marketing** → **Audiences** first.

<Tip>
  Use stable, descriptive custom-property names such as `company`, `planName`, or `renewalDate`. Those keys become personalisation tokens in templates.
</Tip>

## Import a CSV

1. Click **Import**
2. Choose a CSV file
3. Select one or more destination audiences
4. Review how many rows are ready
5. Click **Import**

An email column is required. Header matching is case-insensitive and recognises these aliases:

| Destination | Recognised CSV headers                             |
| ----------- | -------------------------------------------------- |
| Email       | `email`, `email address`, `e-mail`, `emailaddress` |
| First name  | `first_name`, `first name`, `firstname`, `first`   |
| Last name   | `last_name`, `last name`, `lastname`, `last`       |
| Status      | `status`, `subscription status`, `subscribed`      |

Every other non-empty column becomes a custom property.

```csv theme={null}
email,first_name,last_name,company,customer_since
jane@example.com,Jane,Doe,Acme,2024-03-15
alex@example.net,Alex,Smith,Example Co,2025-11-02
```

The completion message separates:

* **Added** — new contact records
* **Updated** — existing contacts matched by the import
* **Skipped** — rows that could not be imported
* **Skipped: subscriber limit reached** — subscribed rows above your plan capacity

<Warning>
  Import unsubscribe and suppression status from your previous provider. Never turn an unsubscribed, bounced, or complained address back into a subscriber merely because it appears in a newer file.
</Warning>

## Export contacts

Click **Export** to download a dated CSV. The file includes:

* `email`
* `first_name`
* `last_name`
* `status`
* `created_at`
* One column for every custom-property key used by the exported contacts

Export from the main Contacts page for the full account or from an audience detail page for only that audience.

## Search and tags

The Contacts page searches email, first name, and last name. Select tags to narrow the results further.

Tags are internal metadata. They help your team organise contacts but do not appear to recipients and do not automatically create an audience. To send a broadcast to a group, place those contacts in an audience.

## Edit a contact

Click a contact row to open its profile. You can:

* Change the email address or name
* Add and remove audience memberships
* Add, update, or remove custom properties
* Add and remove tags
* Change the subscription switch
* Copy the contact ID for log filtering or integration work
* Permanently delete the contact

A saved contact must remain in at least one audience.

### Subscription statuses

| Status           | Meaning                                                      |
| ---------------- | ------------------------------------------------------------ |
| **Subscribed**   | Eligible for marketing sends                                 |
| **Unsubscribed** | Opted out or was manually opted out; excluded from marketing |
| **Bounced**      | Delivery history marked the address as bouncing              |
| **Complained**   | A complaint signal was recorded                              |

Turning **Subscribed** off changes the contact to unsubscribed. Only turn it back on when you have a documented basis to do so, such as a new explicit opt-in.

<Note>
  Unsubscribing and deleting are different. Unsubscribing preserves the opt-out state so future imports do not accidentally mail the address. Deleting removes the contact record.
</Note>

## Delivery performance

The contact profile summarises unique messages from the last 120 days:

* Sent and delivered
* Rejected and bounced
* Unique opens and clicks
* Delivery, open, and click rates
* Most recent delivery, rejection, open, and click timestamps
* Five recent messages, linked to their detailed logs

Use this view when one person reports missing mail. It combines their current eligibility with the receiver-level evidence needed to troubleshoot delivery.

## Subscriber limits

The usage card shows subscribed contacts against the current plan. At 80%, JetEmail warns that you are nearing the limit. At 100%, add or import operations cannot create more active subscribers until you:

* Upgrade the Marketing plan
* Unsubscribe contacts who should no longer receive marketing
* Correct or remove records that do not belong in the account

See [Plans & billing](/docs/marketing/billing) for plan-change behaviour.