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

# Companies & People

> Unified profiles for users and organizations across all your connected platforms

export const Prompt = ({text, variant = 'accent'}) => {
  const [copied, setCopied] = useState(false);
  const handleCopy = async () => {
    try {
      await navigator.clipboard.writeText(text);
      setCopied(true);
      setTimeout(() => setCopied(false), 2000);
    } catch {}
  };
  const clipboardIcon = <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
            <title>Copy</title>
            <rect x="9" y="9" width="13" height="13" rx="2" ry="2" />
            <path d="M5 15H4a2 2 0 0 1-2-2V4a2 2 0 0 1 2-2h9a2 2 0 0 1 2 2v1" />
        </svg>;
  const checkIcon = <svg width="16" height="16" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
            <title>Copied</title>
            <polyline points="20 6 9 17 4 12" />
        </svg>;
  const promptIcon = <svg width="16" height="16" viewBox="0 0 24 24" fill="currentColor" style={{
    flexShrink: 0,
    opacity: 0.4
  }}>
            <title>Prompt</title>
            <path d="M20 2H2v20h2V4h16v12H6v2H4v2h2v-2h16V2zM6 7h12v2H6zm8 4H6v2h8z" />
        </svg>;
  return <div className={`prompt prompt-${variant}`} style={{
    marginTop: '12px',
    marginBottom: '12px'
  }}>
            {promptIcon}
            <span className="prompt-text">{text}</span>
            <button className="prompt-copy" onClick={handleCopy} title="Copy to clipboard" type="button">
                {copied ? checkIcon : clipboardIcon}
            </button>
        </div>;
};

Modem builds profiles for the **people** and **companies** behind your feedback. When someone posts in Slack, opens a GitHub issue, and sends a message on Discord, Modem links those accounts to one person when they share an email address. It also links people to companies and consolidates their activity into a unified view.

## People

### How People Are Created

When Modem ingests messages from your connected platforms, it creates profiles for each message author. As more data flows in, these profiles are enriched with activity from across your sources: messages, topic contributions, feedback patterns, and company associations.

### Cross-Platform Identity

Users often show up on multiple platforms with different usernames and avatars. Modem connects these identities automatically when they share an email address. When a new account's email already belongs to a person, Modem adds the account to that person's profile.

Accounts without a matching email appear as separate people. You can merge them manually from the dashboard (see [Merging People](#merging-people) below).

Each person profile tracks which platform identities are linked to it, so you can always see where someone is active.

### Person Profiles

Click on any person in the People list to see their full profile.

| Section | What it shows |
| - | - |
| **Identity** | Name, avatar, and linked platform accounts |
| **Activity** | Message count and a weekly activity chart for the last 25 weeks |
| **Messages** | Conversations they've participated in, grouped by topic |
| **Company** | Current company and role (when known) |
| **Connections** | External profiles like LinkedIn, GitHub, or Twitter (discovered via [enrichment](#enriching-people)) |
| **Ecosystems** | Technology tags from the person's GitHub activity (e.g. React, Node.js, Rust) |

You can mark people as **VIP** through the Modem Agent or the API to flag high-priority contacts.

### Browsing People

Navigate to **People** in your dashboard to see all users across your data sources. Each row shows the person's name, message count, last seen date, connected platforms, current company, and a 25-week activity chart.

Sort by:

* **Last seen** (default). Most recently active people first.
* **Message count.** Most prolific contributors first.

Filter by:

* **Search.** Find people by name or email address.
* **Ecosystem.** Filter by technology tags (e.g. React, Python).

### Merging People

When the same person appears as separate profiles on different platforms, you can merge them into one. Select multiple people from the list and choose a target profile to merge into. The merged profile consolidates all identities, messages, and activity.

Modem records each merge in an audit trail. You can't revert a merge from the dashboard, the agent, or the API yet.

### Enriching People

Modem can discover additional information about a person, like their LinkedIn profile, GitHub account, title, and technology expertise. Trigger enrichment from a person's profile page. It runs asynchronously and updates the profile when complete.

You can also ask the Modem Agent to enrich profiles:

<Prompt text="Enrich the profile for Alice Chen" />

<Info>Enrichment must be started by a signed-in user. It isn't available through API keys.</Info>

## Companies

Companies represent organizations that your users belong to. They give you an account-level view of engagement by aggregating activity across all the people associated with that organization.

### How Companies Are Created

Modem creates companies automatically from two signals: the Slack workspace a user belongs to, and the work email domain of authors on any connected source. Modem skips free email providers such as gmail.com. You can also create companies manually from the dashboard.

### Company Profiles

Click on any company in the Companies list to see its full profile.

| Section | What it shows |
| - | - |
| **Identity** | Company name, logo, and primary domain |
| **People** | All associated people, their roles, and their activity |
| **Activity** | Aggregate message count, weekly activity chart |
| **Topics** | Conversations involving people at this company |
| **Connections** | Website, email, phone, and LinkedIn |

You can mark companies as **VIP** through the Modem Agent or the API to flag high-priority accounts.

### Browsing Companies

Navigate to **Companies** in your dashboard to see all organizations across your data sources.

Sort by:

* **Last seen** (default). Most recently active companies first.
* **Person count.** Companies with the most known contacts first.
* **Message count.** Companies with the most feedback first.

Filter by:

* **Search.** Find companies by name or domain.

### Enriching Companies

Modem can discover a company's description, website, industry, size, and social profiles. The company page has no enrich button yet, so ask the Modem Agent instead. Enrichment runs asynchronously and updates the profile when complete.

<Prompt text="Enrich the company profile for Acme Corp" />

<Info>Enrichment must be started by a signed-in user. It isn't available through API keys.</Info>

## Asking the Agent

The Modem Agent can query, update, and enrich both people and companies. A few examples:

<Prompt text="Who are the most active users this month?" />

<Prompt text="What has Jane Smith been talking about?" />

<Prompt text="Show me all the people at Acme Corp and what they've been discussing" />

<Prompt text="Mark Acme Corp as VIP" />

<Prompt text="Merge these two profiles for the same person" />

<Prompt text="Which companies have the most bug reports this quarter?" />

## Related

<CardGroup cols={2}>
  <Card title="Topics" icon="https://mintcdn.com/modem-844d7a4a/Wr2r4IRr97lNQiQb/icons/label-alt-multiple.svg?fit=max&auto=format&n=Wr2r4IRr97lNQiQb&q=85&s=e7fbaf23c28396ac670b89cf38e1e4a6" href="/docs/guides/topics" width="24" height="24" data-path="icons/label-alt-multiple.svg">
    See what topics people are discussing.
  </Card>

  <Card title="The Modem Agent" icon="https://mintcdn.com/modem-844d7a4a/Wr2r4IRr97lNQiQb/icons/bot.svg?fit=max&auto=format&n=Wr2r4IRr97lNQiQb&q=85&s=2496f9106cb54fa9f4e27ad1f8f3a171" href="/docs/features/agent" width="22" height="22" data-path="icons/bot.svg">
    Ask questions and take action using natural language.
  </Card>
</CardGroup>


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