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

# Companies: group contacts by the company they work for

> Turn on the Companies add-on, keep each company's details, link contacts to their companies by hand or by email domain, and use company details in your messages.

**Companies** keeps the businesses your contacts belong to. Each company has a name, a web domain, an owner, and any fields you add, and each contact can be linked to one or more companies. It is useful when you sell to businesses: you see who works where, and you can write to everyone at a company in one go.

## Turn Companies on

Companies is a free [add-on](https://help.ciarem.ai/using-ciarem/add-ons.md), off by default. An admin turns it on under **Settings > Add-ons**, on the **Companies** card. **Companies** then appears in the sidebar, right after **Contacts**.

Turning it off only hides it: your companies and the links to your contacts are kept, and come back when you turn it on again.

If your organization is connected to [HubSpot](https://help.ciarem.ai/integrations/hubspot.md), companies sync from HubSpot: **Companies** does not appear in the sidebar and contacts are not linked automatically, because HubSpot is where your CRM is managed. See [Companies in the HubSpot integration](https://help.ciarem.ai/integrations/hubspot.md#companies).

If your organization is connected to [Attio](https://help.ciarem.ai/integrations/attio.md), companies sync from Attio once the Companies add-on is on: **Companies** does not appear in the sidebar and contacts are not linked automatically, because Attio is where your CRM is managed. The Company on a person in Attio is the contact's primary company in Ciarem. See [Companies in the Attio integration](https://help.ciarem.ai/integrations/attio.md#companies).

If your organization is connected to [RD Station CRM](https://help.ciarem.ai/integrations/rdstation.md), companies sync both ways with RD Station organizations once the Companies add-on is on. **Companies** stays in the sidebar and contacts are still linked automatically, because RD Station doesn't do it. The organization on an RD Station contact is the contact's primary company in Ciarem. See [Companies in the RD Station CRM integration](https://help.ciarem.ai/integrations/rdstation.md#companies).

## The companies list

Open **Companies** to see every company, with its domain, owner, and how many contacts it has. From there you can:

* **Search** by name and narrow the list with **Filters** (creation date and your own fields).
* Choose which columns to show.
* Keep the filters and columns you use most as a **saved view**. Views are tabs above the list, next to **Overview**: admins create one with **+**, and right-click or double-click a tab to rename or delete it. An admin's changes to filters and columns save to the open view; everyone else's last only while they look at it.
* **Add company**: give it a name and, optionally, its web domain (for example `acme.com`). Two companies can't share the same domain.
* Select companies to **Delete** them, or to message their contacts (see [Message the contacts of several companies](#message-the-contacts-of-several-companies)). Deleting a company never deletes its contacts.

## The company page

Click a company to open its page. On the left are its fields: **Name**, **Web domain**, **Owner**, and your own fields. Click a field to change it. On the right is the list of the company's **Contacts**: **Add contact** links someone to this company, and removing a contact only removes the link, not the contact. **Delete company** is in the menu at the top.

A company can have a photo: click its avatar at the top of the page to upload one, the same way as for contacts. The page has two tabs, **Contacts** and **Activity**. The **Contacts** tab shows each contact as a card, and **+ Add** opens a search picker: type a name, email or phone and pick the contact. **Activity** lists who created the company, who changed its fields, which contacts were linked or removed, and when a company was made primary, each with who did it: a person, the AI, HubSpot, Attio or an automatic link.

## Company properties

Like contacts, companies can carry your own fields: an industry, a plan, a contract number. Admins add and organize them with **Company properties** on the companies list. Every company then shows those fields on its page, and you can filter the list and show them as columns. Each field has a **Visible to the AI** switch, on by default: turn it off for fields the AI agent must never read.

## Link contacts to companies

You can link a contact to a company by hand from three places:

* the **contact's page**, in its **Companies** tab;
* the contact panel in the **Inbox**, which shows the same company cards;
* the **company's page**, in its **Contacts** tab, with **+ Add**.

The **Companies** tab on a contact shows each company as a card: its photo, domain, owner, number of contacts and some of its fields. Click a card to open the company. **+ Add** lets you search for an existing company or type a new name to create it and link it in one step.

### Linking automatically by email domain

When **Link contacts by email domain** is on, a contact whose email is at a company's domain is linked to that company when the contact is created or their email changes. For example, `ana@acme.com` is linked to the company with the domain `acme.com`, and that company is created if it doesn't exist yet. The setting is on by default; admins switch it off in the settings menu of the companies list (**Company settings**).

Personal email addresses, such as Gmail, Outlook, or Yahoo, are skipped: a contact with `ana@gmail.com` is not linked to anything. Linking automatically never removes a link you made. It does not run for organizations connected to HubSpot or Attio. It keeps running with RD Station CRM.

#### Review automatic links

Links made by the email domain or by the AI wait in **Companies → To review** until someone confirms them. Each row shows the contact, the company, how the link was made (**Email domain** or **AI**), whether it is the contact's primary company, and when it was made. **Confirm** keeps the link and marks it as checked by a person, without changing which company is primary; **Remove** deletes the link and keeps the contact and the company. Tick several rows to confirm or remove them in one step. On a company's page, the **Contacts** tab shows how many of its contacts were linked automatically, with a **Review** button that opens the list for that company only. Agents see only the links of their own contacts.

## The primary company

A contact can be linked to several companies, and one of them is their **primary company**, shown first with a star.

* The first company you link becomes the primary one.
* To change it, open the ⋯ menu on the company's card and choose **Make primary**.
* If you remove the primary company, the oldest remaining link becomes the primary one.

A company linked automatically shows an **Auto** badge: it was linked for you, not by a person. To confirm it, open the ⋯ menu on its card and choose **Confirm link** (or **Make primary** when it is not the primary one). The same menu has **Remove**, which only removes the link.

## What the AI knows about companies

When the Companies add-on is on, your AI agents know which company a contact belongs to.

* The agent always sees the name of the contact's primary company.
* Once a person has confirmed the link, the agent also sees the company's fields marked **Visible to the AI**, and uses them to answer questions about the customer's plan, contract, or account. A link is confirmed when you made it by hand, or when you chose **Confirm link** on an automatic link (or **Make primary** when it was not the primary one).
* While a link is still unconfirmed (it shows the **Auto** badge), the AI only knows the company's name and will not present anything about that company as fact until a person confirms the link.
* When a customer tells the agent where they work, the agent can link them to that company, and creates the company if it is new. That link shows the **Auto** badge until a person confirms it.
* The agent never changes a company's fields.

## Company details in your messages

You can use company details as variables in your messages: in [WhatsApp templates](https://help.ciarem.ai/channels/message-templates.md), messages with buttons or lists, [quick replies](https://help.ciarem.ai/using-ciarem/inbox.md), the AI agent's [welcome message](https://help.ciarem.ai/ai-agent/first-message.md), and WhatsApp forms. In the editor, **Insert variable** has a **Company properties** group:

* `{{company.name}}`: the company's name.
* `{{company.domain}}`: its web domain.
* `{{company.<property>}}`: any of your company fields, by its key (for example `{{company.plan}}`).

The value always comes from the contact's **primary company**, and only once a person has confirmed the link. A company linked automatically (the **Auto** badge) that nobody confirmed leaves the value empty, so the send form asks you for it.

When the Companies add-on is off, or when the contact has no value for it on a send to one person, the send form asks you to type the value yourself, just as it does for a variable you typed by hand like `{{name}}`.

## Message the contacts of several companies

Admins can select companies on the list and click **Message contacts** to send a WhatsApp template to everyone linked to them, the same way a [broadcast](https://help.ciarem.ai/channels/broadcasts.md) works. Each contact receives the message once, even if they are linked to more than one of the selected companies.

## Companies on the Contacts list

While the add-on is on, the [contacts list](https://help.ciarem.ai/using-ciarem/contacts-and-stages.md) has a **Company** column showing each contact's primary company, and a **Company** filter: pick one or more companies to see the contacts linked to any of them, whether it is their primary company or not. Like any filter, you can save it in a segment or send a template to the result.


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