# Contacts and organizations

> Find, create, and manage contacts and organizations: link contacts to an organization, set a primary contact, add custom fields, and delete records.

## Before you start

- Contacts and organizations belong to your account, and everyone on your account can
  see, create, and edit them, admins and members alike. A record's optional **Owner**
  only records which user is responsible for it; it doesn't restrict access.
- An organization is a company, agency, or other entity that one or more contacts
  belong to (older parts of the app call an organization a "contact group").
- Some contacts and organizations are shared into your account by Incenti. They carry
  an **Incenti** chip in the lists and an **Incenti Contact directory** chip on their
  own page, and you can't edit, delete, or tag them.

## Steps

### Find a contact

Open **Contacts** in the sidebar. The page has two tabs, **People** and
**Organizations**, each with a count of your account's own records, and the tab you are
on is kept in the page address, so Back and shared links return to it. The **People**
tab lists contacts with columns for Name, Organization, Tags, Owner, and Updated. Click
the **Name**, **Organization**, or **Updated** header to sort by it, and click again to
reverse. A contact's title, when they have one, shows in small text under their name.
The Organization cell shows the contact's first organization (primary-contact
organizations first) as a link, with **+N** when there are more and the organization's
type underneath. Email and phone aren't columns; open the contact to see them.

_Screenshot: The Contacts tab toolbar and table, showing the search box, Tags filter, Hide Incenti contacts toggle, total count, Import CSV and Create Contact buttons, and the contacts table with Name, Organization, Tags, Email, Phone, Last Updated, and Created columns._

Above the table, **saved views** narrow the list, each with a count:

- **All contacts** is the default.
- **My contacts** shows contacts whose **Owner** is you.
- **Added from email** shows contacts created from logged emails. It appears only when
  your account has email logging turned on.
- **Incenti Contact directory** shows the shared Incenti records.

Incenti directory contacts stay out of **All contacts** unless you tick **Include
Incenti Contact directory**, which appears beside the filters in the **All contacts**
and **Added from email** views.

The search box (**Search name, email, title, organization or tag**) matches a contact's
name, email, title, the names of their organizations, and tag names. It does _not_
match phone numbers. Next to it, the **Organization** filter (type to search) and the
**Tag** filter each narrow the list to one choice. With nothing chosen they read **All
organizations** and **All tags**; once you choose one they show it, for example "Organization: Acme"
or "Tag: Fund", and choosing **All organizations** or **All tags** in the list resets
it. The **Organization** filter lists every organization on your account, so one you
just created can be picked right away; Incenti directory organizations appear in it
only once one of your visible contacts belongs to one. **Clear filters** appears once
any filter, or the Incenti directory checkbox, is on. The footer shows a range such
as "1–25 of 120" and **Rows per page** (10, 25, 50, or 100; the default is 25), with
**Prev** and **Next** buttons. When nothing matches you'll see "No contacts match these
filters" with a **Clear filters** button, or, on an empty account, "No contacts yet"
with **Import** and **New contact** buttons.

Click anywhere on a row (other than a link or checkbox) to open the contact. The ⋯
menu at the end of each row offers **Open contact**, **Add to project**, **Add tag**,
and **Delete**; **Add tag** and **Delete** are missing for Incenti directory contacts.

### Work on several contacts at once

Tick the checkboxes beside contacts (the header checkbox ticks every contact matching
your current view and filters, across all pages). A bar reading "N selected" appears
with:

- **Add to project**: choose a **Project** and a **Role on the project**, **General
  contact** or **Primary contact**, then click **Add to project**. Contacts already on
  that project are reported as not added.
- **Add tag**: choose an existing tag and click **Add tag**. Create new tags first with
  **Manage tags** at the top of the page. See [Tags](https://kb.incenti.co/contacts-and-pipeline/tags.md). Selected Incenti directory
  contacts aren't tagged, and **Add tag** is unavailable when only they are selected.
- **Export**: downloads the selected contacts as a CSV file.
- **Delete**: asks "Delete N contacts?" and, after you click **Delete**, removes them.
  Any selected Incenti directory contacts are skipped, and the dialog says how many.
- **Clear selection**.

The **Export** button at the top of the **People** tab does the same for every contact
matching your current view and filters. The file is named `contacts-` followed by
today's date and has columns First Name, Last Name, Email, Organization Name, Phone,
Title, Other Organizations, Tags, and Owner. The first four match the import template,
so you can edit the file and import it again; the import ignores the rest.

### Browse the Organizations tab

Switch to the **Organizations** tab for the organization list, with columns for
Organization (with its logo, when it has one, and its domain), Type, People, Part of,
Tags, Owner, and Updated. **Organization**, **People**, and **Updated** sort. It has
two saved views, **All organizations** and **Incenti Contact directory**, its own
search box (**Search name, website, phone, type or tag**), its own **Tag** filter (it
reads **All tags** until you choose one), and the same footer paging. Organizations have no checkboxes or bulk bar. Its empty
states read "No organizations yet" and "No organizations match these filters".

_Screenshot: The Organizations tab of the Contacts page, showing the organizations search box, Tags filter, Hide Incenti organizations toggle, Add Organization button, and the table with Organization, Contacts, Sub-Organizations, Tags, Domain, Phone, Last Updated, and Created columns._

### Create a contact

Click **New contact** (on the **People** tab). A panel opens on the right. **First
Name**, **Last Name**, and **Email** are required ("First name is required", "Last name
is required", "Invalid email address"); **Phone**, **Title**, **Owner**,
**Organizations**, and **Industries** are not. **Phone** has a country picker, must be a
valid number ("Enter a valid phone number."), and is saved with its country code.
The **Owner** picker is searchable and lists the users on your account, showing "No
owner" until you choose one; choose the selected user again to clear it. If the
industry you need isn't in the list, choose **Request an industry** to send it to
Incenti for review; it stays out of the picker until it's approved. Click **Create
contact** to save.

_Screenshot: The Create Contact dialog with First Name, Last Name, Email, Phone, Title, Organizations, and Industries fields._

> **Note:** Whenever a contact is created, by hand, by import, or through a form response, we
> also look for an organization whose **Domain** matches the part of the email address
> after the `@`. If one exists, the new contact is linked to it automatically, even if
> you didn't pick an organization. See
> [Import contacts from a CSV](https://kb.incenti.co/contacts-and-pipeline/import-contacts-from-a-csv.md).

### Import contacts from a CSV

Click **Import** at the top of the page to open the **Import contacts** dialog. Its
**Need the right format?** callout has a **Template** button that downloads a blank
file. Then click **Upload CSV** to import a spreadsheet or **Add manually** to type
contacts straight into the preview table. The file must be a `.csv` with the exact
column headers **First Name**, **Last Name**, **Email**, and **Organization Name**, and
at most 5,000 rows. Only the email is required per row.

_Screenshot: The Import Contacts dialog offering Upload CSV, Add Manually, and Download CSV template._

Import has several rules worth knowing before your first run: how rows that match an
existing contact are treated, how organizations are matched, and what arrives when the
job finishes. [Import contacts from a CSV](https://kb.incenti.co/contacts-and-pipeline/import-contacts-from-a-csv.md) covers all of
them.

### Create an organization

Click **New organization** (on the **Organizations** tab). A panel opens on the right.
Fill in **Organization name** (required: "Organization name is required") and
optionally **Description**, **Type** (**EDO**, **Site selector**, or **Other**, which
is the default), **Domain**, **Phone**, **Owner** (a searchable picker of the users on
your account, "No owner" by default), **Parent organizations** (to nest it under
another organization as a sub-organization), and **Industries**, then click **Create
organization**. Setting **Domain** is worth the extra second: it's what lets new
contacts at that company attach to the organization automatically.

Type the **Domain** first and EDOS looks the company up for you. When you click out of
the **Domain** box, a small spinner shows while EDOS fills in **Organization name** with
the company's name, if it finds one, and shows a small preview of the company's logo
marked "Logo from Hunter". EDOS never replaces a name you have already typed, and you can
still edit the name it filled in. To skip the logo, click the **X** next to the preview.
When you click **Create organization**, EDOS saves that logo on the organization. If the
lookup finds nothing, the form simply stays as you typed it.

### Open a contact's page

Click a contact's name to open their page. The header card shows the name, their title
and organization, their email and phone as links, the **Owner**, and their tags (use
**Add tag** to add one; an Incenti directory contact's tags are shown but can't be
changed). The **More actions** menu offers **Edit contact** (which opens
the same panel as **New contact**, with **Save changes**), **Add to project**, and
**Delete contact**. On an Incenti directory contact only **Add to project** is there.

Below the header, the **About** column on the left holds the contact's details, and
most of them are edited in place:

- **Name**, **Email**, **Phone**, and **Title**: click the value, change it, and click
  **Save** (or press Enter; Escape cancels). You can replace a saved value but not
  clear it here: the field says "A saved phone can't be removed here. Enter a new one."
- **Organizations**: the organizations the contact belongs to. A star marks the
  organizations they are the primary contact for, and clicking an empty star makes
  them the primary contact. The **X** removes the contact from an organization, and
  **Add organization** adds one.
- **Industries**: click the pencil to pick industries, then **Save**. **Request an
  industry** sits in the picker.
- **Owner** (not shown on Incenti contacts): click it and pick a user. It saves at
  once. Pick the current owner again to leave it unassigned, then click **Done**.
- **Addresses**: **Add address** opens a panel that requires **Address line 1**,
  **City**, **State/region**, and **Postal code**; **Address line 2** and **Country**
  aren't required. Pick an **Address type** of Main, Mailing, Billing, or Other.
  Deleting an address asks you to confirm and can't be undone.
- **Custom fields**: your own fields. **Add field** asks for a **Field name** and a
  **Value**, both required ("Both field name and value are required"), and field names
  must be unique on the record ("A field with this name already exists"). The pencil
  beside a field (**Edit custom field**) changes it and the **X** removes it.
- **Record**: where the contact came from (Added in EDOS, Imported, or Created from a
  logged email) and when it was created and last updated.

The main area to the right has tabs, each with a count where it makes sense:

- **Activity** (the tab that opens first): a newest-first feed of what happened with
  this contact, such as notes added, emails logged or linked, tasks added or
  completed, responses submitted, and the contact being added.
  Click **Load more** at the bottom for older entries. A contact with no history reads
  "No activity yet".
- **Emails**: the logged email conversations. It appears only when your account has
  email logging turned on.
- **Notes**: see [Notes](https://kb.incenti.co/contacts-and-pipeline/notes.md).
- **Responses**: the form responses this contact submitted or contributed to, with
  their status and date ("Started" followed by a date when a response hasn't been
  submitted yet) and an **Open** button. With none, it reads "No responses yet".
- **Documents**: "Documents linked to" the contact, where you can upload and manage
  their files.
- **Properties**: the properties the contact is connected to, through a submitted
  response, on a small map. With none, it reads "No properties yet". The tab is always
  there.

Tags work the same way here as everywhere else in the app; see [Tags](https://kb.incenti.co/contacts-and-pipeline/tags.md).

### Open an organization's page

Click an organization's name to open its page. The header card shows its logo (when it
has one), name, type, **Part of** (its parent organizations), domain, phone, the number
of people, the **Owner**, and its tags (shown but not changeable on an Incenti directory
organization). **Add person** creates a new contact already
linked to this organization. The **More actions** menu offers **Edit organization**,
**Set primary contact**, and **Delete organization**; on an Incenti directory
organization there is no menu. **Edit organization** doesn't change parent
organizations; do that from **Part of** in the **About** column (see
Work with sub-organizations below).

The **About** column works like a contact's: **Type** (a drop-down that saves as soon
as you pick), **Name**, **Website** (the same value as **Domain** in the create panel),
**Phone**, and **Description** edit in place, followed by **Part of**, **Industries**,
**Owner**, **Addresses**, **Custom fields**, and **Record**.

_Screenshot: The organization detail page's Overview tab, showing the Organization Information card and the Primary Contact card with its Change Primary Contact button._

The tabs are **People** (the tab that opens first), **Sub-organizations**,
**Activity**, **Emails**, **Notes**, **Documents**, and **Properties**. **Activity**,
**Emails**, **Notes**, and **Properties** work as they do on a contact; **Documents**
reads "Documents linked to" the organization.

The **People** tab lists everyone linked to the organization with their title, email,
and phone; a search box (**Search people**) appears once there are more than six.
Click **Link existing contact** to open **Manage contacts**, check or uncheck contacts,
and click **Save changes** (nothing changed gives you a "No changes made" message), or
click **Add person** to create a brand-new one already linked here.

### Set a primary contact

The primary contact is the main point of contact at an organization, marked with a
star. On the organization's **People** tab, click the empty star beside someone. Or open
**More actions** → **Set primary contact**, pick someone already linked to the
organization ("Select a contact to set as the primary contact for this organization"),
and click **Set as primary**. On a contact's own page, the star on an organization in
the **Organizations** row does the same. **Set primary contact** is unavailable until
the organization has at least one person.

### Work with sub-organizations

The **Sub-organizations** tab is always on an organization's page, with a count. It
lists each sub-organization with its type and number of people, and has **Link
existing** and **New sub-organization** (a new organization already nested under this
one). **Link existing** opens **Manage sub-organizations** ("Select or deselect
organizations to link or unlink as sub-organizations"), where you check and uncheck
organizations and click **Save changes**. With none, the tab reads "No
sub-organizations".

To put an organization _underneath_ another from the lower one, open its **About**
column, click **Add parent organization** under **Part of**, choose a **Parent
organization**, and click **Add parent**. The **X** beside a parent removes the link.
This is also how you change the parents of an existing organization: the **Parent
organizations** picker appears only in **New organization**, not in **Edit
organization**.

### Delete a contact or organization

Delete a contact from its page (**More actions** → **Delete contact**), from the row
menu or bulk bar on the list, or an organization from its page (**More actions** →
**Delete organization**). Each asks you to confirm first. Deleting a
contact removes it (and its addresses, tags, and organization links) from your lists,
but it does not delete responses or opportunities the contact was already linked to,
and those keep their own record of the submission or relationship. Deleting an
organization works the same way for its contacts and links.

> **Warning:** The confirmation dialog on a record's page says the record "will be permanently
> removed", but a delete is really a hide: the record stops appearing anywhere in the
> portal, and importing a CSV with the same email address later brings the same contact
> back, with its original name and history, rather than creating a new one. There's no
> **Restore** button in the portal, so contact support if you need a deleted record back
> and can't re-import it.

## What happens next

- A CSV import runs in the background. You'll see "Import started — you'll be notified
  when complete" right away, contacts appear in the list as the job works through the
  rows, and when it finishes you get both a bell notification ("Import Complete: N of
  M processed") and an email listing any rows that failed and why.
- Deleting a contact or organization takes effect immediately for everyone on your
  account.
- Creating a contact whose email domain matches an organization's **Domain** links the
  two straight away, with no further confirmation.

## Common questions

**Q: Why doesn't searching for a phone number find my contact?**
A: The search box on the **People** tab matches name, email, title, organization
names, and tag names, but not phone numbers. Open a contact to see their phone. Inside
an organization's **People** tab, **Search people** does match phone, along with name,
email, and title.

**Q: A contact I never linked to anything is showing under an organization. Why?**
A: Contacts are matched to organizations by email domain. If an organization has its
**Domain** set to `example.com`, every contact created with an `@example.com` address
is linked to it automatically. Open the contact and use the **X** beside the organization in the **Organizations**
row of **About** (or **More actions** → **Edit contact**) if that's not what you want.

**Q: I see contacts with an "Incenti" chip that I didn't create. What are those?**
A: They're shared into your account by Incenti and are read-only: you can't edit or
delete them. They are kept out of **All contacts** unless you tick **Include Incenti
Contact directory**, and the **Incenti Contact directory** view lists only them.

**Q: Can I import organizations from a CSV too?**
A: Not on their own, but the contact import creates them for you from the
**Organization Name** column. Organizations with no contact to attach are added one at
a time with **New organization**. See
[Import contacts from a CSV](https://kb.incenti.co/contacts-and-pipeline/import-contacts-from-a-csv.md).

**Q: A contact I deleted came back. How?**
A: Someone imported a CSV containing that email address. An import restores a
previously deleted contact instead of creating a second one, so a stale spreadsheet
can bring back records you cleaned up.

**Q: How do I move a contact to a different organization?**
A: Open the contact and, in the **Organizations** row of **About**, remove the old
organization with its **X** and click **Add organization** to pick the new one. You can
also do it from the organization side with **Link existing contact** on its **People**
tab.

**Q: What does the Owner on a contact do? Does it limit who can edit it?**
A: No. Owner only records which user on your account is responsible for the record;
everyone on the account can still see and edit it, and nobody is notified when an
owner is set. Change it in the **Owner** row of **About**, or with **Edit contact** or
**Edit organization**. The **My contacts** view lists the contacts you own.

**Q: Why can't I change the parent organization when I edit an organization?**
A: **Edit organization** no longer shows the **Parent organizations** picker; it is
only in **New organization**. To change the parents of an existing organization, open
its page and use the **About** column: click **Add parent organization** under **Part
of** to add one, or the **X** beside a parent to remove it.

**Q: Where did the Overview tab go?**
A: Contact and organization pages no longer have an **Overview** tab. The details
that were there now sit in the **About** column beside the tabs, and you edit most of
them in place. The Statistics and Primary Contact cards are gone: counts are on the
tabs, and an organization's primary contact is the star on its **People** tab.

**Q: Why can't I clear a phone number or title I saved?**
A: In the **About** column you can replace a saved value but not empty it; the field
says "A saved phone can't be removed here. Enter a new one." Clearing a saved value
isn't supported there yet.

**Q: Can I set owners in the CSV import?**
A: No, the import reads only First Name, Last Name, Email, and Organization Name. Set
owners afterwards with **Edit contact**.

## Related

- [Import contacts from a CSV](https://kb.incenti.co/contacts-and-pipeline/import-contacts-from-a-csv.md)
- [Notes](https://kb.incenti.co/contacts-and-pipeline/notes.md)
- [Tags](https://kb.incenti.co/contacts-and-pipeline/tags.md)
- [Pipelines](https://kb.incenti.co/contacts-and-pipeline/pipelines.md)
- [Received and Submitted responses](https://kb.incenti.co/responses/received-vs-submitted-responses.md)
