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

# Contacts

> How contacts arise from sending, how you search, view and edit them and what they cannot do.

Contacts are the recipients of your offers. You find them in the menu under **Contacts**. The page shows "Contact people and companies from your offers." Every workspace has its own contacts. The same address in two workspaces results in two separate contacts.

## How contacts arise

A contact is created automatically when you send an offer (see [Sending](https://docs.hocdoc.com/en/guides/sending.md)). The recipient's email address is the key, and upper and lower case do not matter. If a contact for this address already exists in the workspace, the offer is assigned to it. Otherwise HocDoc creates a new one, with the details from "Recipient name" and "Company (optional)" in the send dialog.

As long as there has been no send, it says "No contacts yet".

### Resending to the same address

* The offer stays with the same contact, no second one is created.
* The name from the send dialog replaces the contact's previous name.
* A company from the send dialog replaces the previous one. If you leave the field empty, the known company stays on the contact.
* If you changed name or company on the contact itself (see below), a send no longer overwrites them. This applies to each field separately and also if you emptied a field by hand.
* The send does not know phone and note. They always stay.

### Resending to a different address

If you send an existing offer again to a different address, the offer moves to the contact of that address. The previous contact remains.

## The list

Above the list you choose between **People** and **Companies**. The list shows 25 entries per page. If there are more, you page at the bottom with **Back** and **Next**. It is sorted by last activity, the most recent first. That is the most recent event across all of the contact's offers, otherwise the last change to the contact.

### People

| Column | Content |
| - | - |
| **Name** | The name, otherwise "No name". |
| **Email** | The address. |
| **Company** | A click on the company searches the people view for this company name. |
| **Offers** | Number of offers to this contact. |
| **Accepted** | Number of accepted offers. |
| **Last activity** | Relative time of the most recent event. The "Expired" event does not count here. |

A click on a row opens the detail page.

### Companies

Companies are not a record of their own. HocDoc derives them from the **Company** field of the contacts and combines identical names regardless of upper and lower case. The spelling of the most recently updated contact is shown. Contacts without a company do not appear in this view.

The columns are **Company**, **Contacts**, **Offers**, **Accepted** and **Last activity**. A click on a company switches to the people view and searches for this company name.

### Search

The **Search contacts** field searches in the people view by name, email and company ("Search by name, email, company"), in the companies view by company ("Search by company"). The search starts automatically shortly after you stop typing. It finds parts of a term, and upper and lower case do not matter. Special characters such as `%` are searched literally.

The search term is not in the address bar and not in the browser history. Reloading the page therefore resets the search. Above the list is the number of hits. If there is no hit, "No contacts found" appears with the **Reset search** button.

## Detail page

The detail page has three parts.

1. **Contact:** Name, email (as a mail link), company, phone and note. A click on the company leads to the contact list and searches there for this company name. A phone number is a call link if it is a single dialable number. If the field contains additions such as "Reception" or two numbers, it appears as text. If the note is missing, it says "No note".
2. **Key figures:** **Offers**, **Open** (sent, not yet accepted or declined), **Accepted** and **Last activity**. An offer whose expiry date has been reached no longer counts as open.
3. **Offers:** All offers to this contact with **Offer**, **Status**, **Value**, **Sent**, **Valid until** and **Last activity**. A click on a row opens the offer. The value comes from the sent version.

## Edit a contact

In the "Edit contact" dialog you maintain four fields:

| Field | Limit |
| - | - |
| **Name** | at most 200 characters |
| **Company** | at most 200 characters |
| **Phone** | at most 50 characters |
| **Note** | at most 2000 characters, "Only visible to your team." |

**1. Open the contact**

Click the contact in the list.

**2. Choose Edit**

Click **Edit** and change the fields you want to maintain.

**3. Save**

Click **Save**. With **Cancel** you discard the change.

What you should know when editing:

* The **Email** address is only shown in the dialog: "The address cannot be changed. Sending uses it to match offers to this contact." For a different address, you send the offer to that address, and a separate contact is created.
* Empty fields are allowed. An empty field is cleared on the contact.
* Control characters and line breaks in name, company and phone become spaces, and spaces at the edges are dropped. In the note, line breaks in the text are kept, and at the edges they are dropped.
* Only the fields you changed are saved. A field you did not touch stays, even if the page is outdated.
* If someone else (or a send) has meanwhile changed a field that you also changed, nothing is saved. It says: "The contact has been changed in the meantime. Please reload the page and enter your change again."
* The recipient details on the offer itself stay the state of the respective send. A change to the contact does not change them.

## Roles

All roles can view and search, including **Viewer**. The **Edit** button is seen by **Owner**, **Admin** and **Member**. Anyone who tries to save without write access gets: "You don't have write access in this workspace." More about roles: [Team and roles](https://docs.hocdoc.com/en/guides/team-and-roles.md).

## Limits

* Contacts cannot be created by hand. They only arise when sending.
* Contacts cannot be deleted and cannot be merged.
* There is no import.
* A contact's email address cannot be changed.
* Companies cannot be edited individually. You change the **Company** field on the respective contact.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.