> For the complete documentation index, see [llms.txt](https://help.usejimo.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.usejimo.com/docs/analyze/users-and-segments/audience/companies.md).

# Companies

The accounts your users belong to. Every company your app sent to Jimo, with its members, its shared attributes and its activity.

**Dashboard path:** [Users & Segments > Audience > Companies](https://i.usejimo.com/companies) (`/companies`)

***

## What a company is

A company groups the users of one of your customer accounts. Your app tells Jimo which company each user belongs to, and Jimo keeps one record per company: its name, its attributes, its members.

A user belongs to **one company at a time**. When your app sends another company ID for the same user, the user leaves the first company and joins the new one.

A company holds two kinds of data:

| Data                   | Belongs to                                        | Examples                            |
| ---------------------- | ------------------------------------------------- | ----------------------------------- |
| **Company attributes** | The company. Every member shares the same values. | `plan`, `tier`, `domain`, `country` |
| **Membership**         | One user, inside that company.                    | `role`, `team`                      |

When your app updates a company attribute for one user, every member of that company gets the new value. A membership value stays on the user who sent it.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FN6ZAv98y24cT2DEz0Kd3%2Fusing-companies-company-vs-membership-v01.png?alt=media&#x26;token=2cbd8b81-0dfc-43ec-9801-b8982066b5a6" alt="A company holds shared company attributes for every user, and each user keeps a membership with their own role and team"><figcaption></figcaption></figure>

### How companies get into Jimo

Jimo never guesses a company. Your app sends it, in one of three ways:

* the [`set company` SDK command](https://help.usejimo.com/docs/for-developers/for-developers/sdk-methods.md#set-the-users-company);
* a nested `company` object in [`set user:attributes`](https://help.usejimo.com/docs/for-developers/for-developers/sdk-methods.md#from-the-user-attributes);
* a CSV import with a **Company Identifier Field**.

The first time Jimo receives a company ID, it creates the company. The company's `name` attribute becomes its name in the dashboard. Without one, the company shows its ID.

{% hint style="info" %}
**The list stays empty until your app sends a company.** Identifying users is not enough: a user with no company sent for them belongs to none. The empty page says so: *Identify users with a nested company object or the set company command to populate this list.*
{% endhint %}

### A worked example

The admin of the Acme account logs in. Your app sends their company, then identifies them:

```javascript
window.jimo.push(["set", "company", [
  "acme-001",
  { name: "Acme", domain: "acme.com", plan: "Enterprise Plus" },
  { membership: { role: "admin", team: "Finance" } }
]]);
```

The second argument holds the company attributes, shared by every member of Acme. The third holds this user's membership: their role and team inside Acme, which other members do not get.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FZqlNuCDLvmAef1z0TmRY%2FP-i01-one-call-three-places.png?alt=media&amp;token=416303a1-cf79-4157-bea7-ade9a26a3389" alt="One set company call and where its values show: the Companies list row, the company details attributes, and the company attributes of the user&#x27;s profile with their membership"><figcaption></figcaption></figure>

The screenshots on this page come from a test project where the same company is named **\[Doc] Acme**, with three users.

***

## The Companies page

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FAxkqiIFDbLUH9qJ9FwDw%2FP-s01-companies-page.png?alt=media&amp;token=d598b2dd-be5a-4206-a92e-f900b34147e6" alt="Companies page with the Identified Companies and Reached by Jimo Experience cards, the search bar, the sort menu and four companies with their domain, last activity, first seen date and tags"><figcaption></figcaption></figure>

### The two cards at the top

#### Identified Companies

How many companies your app has sent to Jimo, with the change over the last 30 days. The number is always the project total. When you search or filter, the card keeps the total and adds how many companies match, for example *1 matches your search* or *1 matches your filters*.

#### Reached by Jimo Experience

How many companies have at least one member who saw one of your experiences.

Each card shows **Not enough data yet** until it has data on two different days: companies identified on two different days for the first card, members who saw an experience on two different days for the second.

### The company list

| Column            | What it shows                                                                                                                   |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------- |
| **Company**       | The logo, the company name, and the company ID underneath. A company without a `name` shows its ID.                             |
| **Domain**        | The company's website. Click it to open the site in a new tab. See [Where the Domain comes from](#where-the-domain-comes-from). |
| **Last activity** | The company's most recent activity.                                                                                             |
| **First Seen**    | When Jimo first received this company.                                                                                          |
| **Tags**          | The company's tags.                                                                                                             |

An empty cell shows a dash.

Click a row to open the company details. The **...** menu at the end of the row offers **View company details** and **Delete company**.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FPkzn32bx3f6R7gAZ3fvq%2FP-s06-companies-row-menu.png?alt=media&amp;token=c1cb6ead-257b-44c2-9657-36d61a188889" alt="The row menu of a company open on View company details and Delete company"><figcaption></figcaption></figure>

#### Where the Domain comes from

The Domain column reads the company attribute `domain`. Send the bare host, such as `acme.com`.

When `domain` is missing, Jimo looks for these company attributes, in this order: `website`, `url`, `companyDomain`, `host`. The first one with a value wins. If none has one and the company name itself looks like a domain (`acme.com`), the name is used.

Whatever the attribute, Jimo shows only the host: `https://www.acme.com/pricing` shows as `acme.com`.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fd6FJDYA50xKWLtbA7cJm%2Fusing-companies-domain-fallback-v01.png?alt=media&#x26;token=583f20fd-6ec3-476e-8ae8-9084d80c99a9" alt="The Domain column reads domain first, then website, url, companyDomain and host, then the company name, and shows only the host"><figcaption></figcaption></figure>

The logo is the website's icon, taken from the same domain. A company without a domain shows a generic company icon.

```javascript
window.jimo.push(["set", "company", ["acme-001", { name: "Acme", domain: "acme.com" }]]);
```

### Search and sort

The search bar matches a company's name or its company ID.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FKlEVfNOcI4vLbfRgMUyW%2FP-s03-companies-search.png?alt=media&amp;token=0d6d21c6-5ffc-4092-9e70-0ef392b4c485" alt="A search for acme keeps one company, and the Identified Companies card reads 1 matches your search"><figcaption></figcaption></figure>

Four sort options:

* **Recently active**: last activity first. The default.
* **Recently created**: newest first.
* **Most members**: largest companies first.
* **Name**: alphabetical, by the label each row shows. A company without a name is sorted by its ID.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FqbFdDIXFx0wl9jX6ogqq%2FP-s02-companies-sort.png?alt=media&amp;token=2ac94458-0e1e-40b3-aa7d-d072c0135a88" alt="The sort menu with Recently active, Recently created, Most members and Name"><figcaption></figcaption></figure>

### Filtering

**Filter** opens the **Add Rule** window. Its rules are grouped in sections:

| Section                | What the rules read                                                                                                                                                                                                         |
| ---------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Tags**               | The tags of the company's users. A tag set on the company itself is not available as a rule yet.                                                                                                                            |
| **Company Attributes** | Company ID, Company Name, Company Domain, Company Last activity and Company created time, then every attribute your app sent (shown as **Company** followed by its name), then **Membership role** and **Membership team**. |
| **Company Segments**   | Whether the company is in one of your company segments. The section appears once the project has at least one company segment.                                                                                              |
| **Experiences**        | Whether the company's users have seen, completed or dismissed an experience, or have not, and **Answered with** for a survey answer.                                                                                        |
| **No-Code Events**     | The no-code events of your project.                                                                                                                                                                                         |

A company attribute sent as a nested object shows with a dotted name: `{ billing: { plan: "pro" } }` gives the rule **Company billing.plan**.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FMIfzsfQjy5G0j6xijOx2%2FP-s04-companies-filter-add-rule.png?alt=media&amp;token=4f9449de-8bfd-4ca6-a774-c0db6190df15" alt="The Add Rule window with its sections Tags, Company Attributes, Company Segments, Experiences and No-Code Events, open on the tags and the first company attributes"><figcaption></figcaption></figure>

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FG7af9T752FP1iYGIbCLf%2FP-s17-companies-filter-segments-experiences.png?alt=media&amp;token=61509d89-ec8b-42ab-9b98-47e9c5efedae" alt="The Add Rule window scrolled to Company Segments and the Experiences rules: Answered with, Has been completed, Has been dismissed, Has been seen and their opposites"><figcaption></figcaption></figure>

A membership rule matches a company when **at least one of its users** matches it: **Membership role** is `admin` keeps every company that has an admin.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FzA0LiST5OnTvRZccVP2C%2FP-s05-companies-filter-membership-role.png?alt=media&amp;token=7355cc29-0d2c-46b1-ad88-60d4faccdbdc" alt="The filter Membership role is admin keeps one company out of four, and the Identified Companies card reads 1 matches your filters"><figcaption></figcaption></figure>

**Clear** removes the rules. The same rules build company segments.

### Deleting a company

**Delete company**, in the row menu or in the **...** menu of the company details, asks for confirmation: the company and its company attributes are removed from Jimo, and this cannot be undone.

The users are not deleted. They stay in Jimo with no company: the company and its attributes disappear from their profiles. The deletion can take a minute to show in the list.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fn7ydZzQKGkK3dQxNeMVK%2FP-s09-company-details-menu.png?alt=media&amp;token=ef3ad431-1875-43c0-ab16-c3b788e08f93" alt="The menu of the company details, with Delete company"><figcaption></figcaption></figure>

***

## Company details

The side panel shows everything Jimo knows about one company.

The header shows the logo, the name, the domain and the company ID, with a button to copy the ID. The tag chip sets the company's tags: it reads **Add tag...** on a company with none, and the number of tags once there are some, for example **1 tag**. Companies and users share the same tags, created on the Tags page.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2Fa5hgdDC8AwCHj7DUJcFL%2FP-s07-company-details-data.png?alt=media&amp;token=8f6d01d0-59a6-44aa-bd34-26b81b0ec06d" alt="Company details of [Doc] Acme on the Data tab: domain, company ID and tag chips, First seen, Last seen, Experience engaged, Segments and the attributes with their source, Jimo or Custom"><figcaption></figcaption></figure>

Three tabs:

{% tabs %}
{% tab title="Data" %}
**First seen**, **Last seen**, and **Experience engaged**: how many different experiences the company's users have seen.

**Segments**: the company segments this company is in.

**Attributes**: every attribute of the company, with its value and its source. `name`, `companyID`, `firstSeen` and `lastSeen` come from Jimo. Everything your app sent has the source **Custom**. A search field filters the list.

**Users in this company**: every user in the company, with a search field and a **Sort by** menu: Last activity, Name or First seen. Click a user to open their profile.
{% endtab %}

{% tab title="Activity" %}
What the company's users did with your experiences and your events, most recent first. The filter narrows it to **Tours**, **Survey Responses** or **Events**; **All type** shows everything.
{% endtab %}

{% tab title="Survey Responses" %}
The answers the company's users gave to your surveys. A company whose users have not answered reads **No responses found**.
{% endtab %}
{% endtabs %}

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FomU6Ah3sYivSxQvy6zgo%2FP-s08-company-details-users.png?alt=media&amp;token=daf007da-3cca-4934-8fdf-d4035acd63fe" alt="Users in this company: three users with their email, a search field and the Sort by menu"><figcaption></figcaption></figure>

On a user's profile, the company appears under the user's name: click it to open the company. The **Data** tab lists **Company attributes** below **User attributes**, with the source **Company** for shared values and **Company membership** for the user's own role and team. See User details.

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F3ddTWPYLNKj6ZjDuRDjq%2FP-s10-user-profile-company-chip.png?alt=media&amp;token=62e1a3c7-36f6-40a9-8598-7e63644bcf2d" alt="A user profile with the company [Doc] Acme under the user&#x27;s name"><figcaption></figcaption></figure>

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FvMBWXyxf60aouqI6XLPy%2FP-s11-user-profile-company-attributes.png?alt=media&amp;token=e218c3e0-dcbb-422e-94de-48121217f3bb" alt="Company attributes of a user: companyId, domain, modules, name and plan with the source Company, Membership role admin and Membership team Finance with the source Company membership"><figcaption></figcaption></figure>

***

## What a company attribute can hold

Strings, numbers, booleans and lists. A value must stay under 700 characters.

A list holds plain values only: strings, numbers or booleans. Each item must stay under 700 characters, and there is no limit on the number of items.

A list that holds an object or another list is refused, and nothing from that call is stored. The SDK prints the reason in the browser console, with the attribute name, for example `[Jimo] set company refused: ATTRIBUTE_VALUE_NOT_SUPPORTED (tags)`.

Sending `null` for a company attribute removes it from the company, for every member.

***

### Related pages

* [Users](https://help.usejimo.com/docs/analyze/users-and-segments/audience/users.md): the people behind each company
* [Segments](https://help.usejimo.com/docs/analyze/users-and-segments/audience/segments.md): user segments and company segments
* [Attributes](https://help.usejimo.com/docs/analyze/users-and-segments/data-management/attributes.md): user attributes and company attributes
* Imports: attach users to companies from a CSV
* [SDK Methods](https://help.usejimo.com/docs/for-developers/for-developers/sdk-methods.md#set-the-users-company): the `set company` command
