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

# Contacts

> Manage your counterparty directory in Breezing: name wallet addresses, import contacts via CSV, and map them to QuickBooks entities.

Every wallet address you name in Breezing lives in your Contacts directory. A named address shows its name on every transaction it appears in, past and future, which turns anonymous hex strings into readable counterparties like "Blockchain Customer" or "MME Legal".

### The Contacts Page

Navigate to **Contacts** on the left menu. The table lists each contact's address, name, and chain, and the search box lets you look up contacts by address or name. Click any row to edit it.

### Adding Contacts One by One

1. Click **Add Contact(s)** > **Add Contact**.
2. Fill in the **Contact Name**, the **Contact Address**, and the **Chain**.
3. Click **Add**.

Each address can exist only once per company; if the address is already in your directory, edit that contact instead. You can also name addresses directly from the transaction table while categorizing, as covered in [Categorizing Transactions](/features/categorizing-transactions); those names land in the same directory.

### Importing Contacts via CSV

If you already have a list of known addresses, upload them in one go:

1. Click **Add Contact(s)** > **Upload CSV**.
2. Prepare a CSV with two columns: `address` and `name`.
3. Drop the file in the upload area (up to 50 MB).
4. Breezing validates every row and shows how many contacts were accepted and how many were ignored, with an error log you can expand for line-by-line details.

If an address in the file already exists in your directory, it is updated with the new name rather than duplicated.

### Exporting Contacts

The **Download** button on the Contacts page exports your directory as a CSV. If a search filter is active, only the matching contacts are exported.

### Mapping Contacts to QuickBooks Entities

When QuickBooks is connected, editing a contact reveals a QuickBooks entity picker. Click **Refresh Entities** to pull the latest customers and vendors from QuickBooks, then select the entity this contact belongs to.

This mapping is what lets Breezing assign synced journals to the right QuickBooks customer or vendor, and it is a prerequisite for [closing QuickBooks invoices and bills](/integrations/quickbooks) from Breezing.

### Why Naming Pays Off

Contact names are more than labels. You can filter transactions by contact, and [automation rules](/features/automation-rules) can match on Contacts, so a well-maintained directory is what makes rules like "everything from this customer is Sales" possible.