> 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.md).

# Users & Segments

Your user base in one place. Browse users, build audience segments, and import data via CSV.

Understand who uses your product and build the audiences that will receive your experiences. This section is the data foundation behind all targeting, personalization, and measurement in Jimo.

**Dashboard path:** [Users & Segments](https://i.usejimo.com/users) (`/users`)

***

## Dashboard structure

<figure><img src="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FZaEHzn94MUjDyMDTfUx2%2FD2-r01-users-segments-nav.png?alt=media&amp;token=206669b3-3f55-40f1-8de6-152706736a70" alt="Users &#x26; Segments navigation of the dashboard: A the Audience group with Users and Segments, B the Data Management group with Attributes and Tags, C Imports on its own"><figcaption></figcaption></figure>

The section is organized in two groups, plus imports:

| Group               | Pages            | What it is for                                   |
| ------------------- | ---------------- | ------------------------------------------------ |
| **Audience**        | Users, Segments  | The people you can reach, and how you group them |
| **Data Management** | Attributes, Tags | The data your audiences are built on             |
|                     | Imports          | Bulk-upload users and attributes via CSV         |

{% hint style="info" %}
In the dashboard, **Imports** sits on its own below the two groups. In this documentation it lives under **Data Management**, because importing a CSV is how you get data in, just like the SDK or an integration. Same feature, one click away either way.

**Variables** are not in the Users & Segments menu: you insert them from the variable picker of the builder's text and action fields. They are documented under **Data Management** because they read the same attributes. See [Variables](https://help.usejimo.com/docs/analyze/users-and-segments/data-management/variables.md).
{% endhint %}

The split is meaningful:

* **Data Management decides what you are able to say about a user.**
* **Audience decides what you do with it.**

Each page carries its own actions:

| Page                | Actions                             |
| ------------------- | ----------------------------------- |
| **Users**           | Import from CSV, Filter             |
| **Segments**        | Import, + New Segment               |
| **Segment details** | Export                              |
| **Attributes**      | + New Attribute, Install Attributes |
| **Tags**            | + New Tag                           |
| **Imports**         | Import users from CSV               |

{% hint style="info" %}
Users, Segments and Attributes each have their own search bar. Search finds an existing item by name. To narrow the user list by data instead, use the **Filter** builder on the Users page.
{% endhint %}

***

## Core concepts

{% tabs %}
{% tab title="Users" %}
A **user** is anyone who visits a page where the Jimo snippet is installed. Each user gets a unique **Jimer ID** automatically.

Once [identified via the SDK](https://help.usejimo.com/docs/for-developers/for-developers/sdk-guides/identify-users.md), a user profile accumulates over time:

* **Attributes**: native fields (name, email, sessions) + custom fields you push (plan, role, language...)
* **Experience interactions**: which Jimo experiences the user has seen, completed, or responded to
* **Events**: in-app actions tracked by Jimo or imported from integrations
* **Segment membership**: which segments the user currently belongs to
  {% endtab %}

{% tab title="Segments" %}
A **segment** is a dynamic group of users defined by conditions. It updates automatically: users enter when they match, leave when they don't.

Segments are reusable across Jimo:

* [**Experience targeting (Who)**](https://help.usejimo.com/docs/publish/target-right-people-who.md): show a tour only to "Trial users"
* **Filtering**: narrow the user list to a specific audience
* **Analytics**: compare experience performance across cohorts
* **Composition**: use a segment as a condition inside another filter
* **Export**: reuse segments externally via static user list file download
  {% endtab %}

{% tab title="Attributes" %}
Attributes are the building blocks of segments and filters. They come from five sources:

| Source           | Examples                                        | How they arrive                                                                                                                                                                                                                         |
| ---------------- | ----------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Jimo SDK**     | Name, Email, Last activity, Sessions, Created   | Automatic (snippet + SDK identification)                                                                                                                                                                                                |
| **Custom**       | Plan, role, language, signup date               | Defined in [Attributes](https://help.usejimo.com/docs/analyze/users-and-segments/data-management/attributes.md), pushed via the [SDK](https://help.usejimo.com/docs/for-developers/for-developers/sdk-guides/setup-the-segmentation.md) |
| **Integrations** | Any field from your CRM or analytics tool       | Synced from [HubSpot, Salesforce, Segment, PostHog...](https://help.usejimo.com/docs/integrations/integration-setup.md)                                                                                                                 |
| **Experiences**  | Seen Tour X, Completed Survey Y, Answered "Yes" | Automatic when users interact with experiences                                                                                                                                                                                          |
| **Events**       | Clicked "Upgrade", Visited /settings            | Created in [Success Tracker](https://help.usejimo.com/docs/analyze/success-tracker.md) or imported                                                                                                                                      |

[**Tags**](https://help.usejimo.com/docs/analyze/users-and-segments/data-management/tags.md) are the sixth ingredient, and the only one that comes from no system at all: you apply them by hand.

{% hint style="success" %}
The more you enrich user profiles, the more precise your segments become. Start with plan + role + language for quick wins.
{% endhint %}
{% endtab %}
{% endtabs %}

***

### Why identification matters

[Identification](https://help.usejimo.com/docs/for-developers/for-developers/sdk-guides/identify-users.md) (`user:id`, `user:email`, `user:name`) is the prerequisite for everything in this section.

{% tabs %}
{% tab title="Without identification" %}
Jimo sees anonymous sessions. It can show experiences to everyone, but cannot:

* Build persistent profiles across sessions or devices
* Use custom attributes for segmentation
* Track individual journeys over time
* Personalize content (e.g. "Hello {name}")
  {% endtab %}

{% tab title="With identification" %}
Jimo links every session to a known user. This unlocks:

* Cross-session profiles with full attribute history
* Dynamic segments that update in real time
* Precise targeting by plan, role, behavior, or any custom data
* Cohort analytics in [Success Tracker](https://help.usejimo.com/docs/analyze/success-tracker.md)
* Personalized content using [variables in the builder](https://help.usejimo.com/docs/build/builders.md)
  {% endtab %}
  {% endtabs %}

{% hint style="warning" %}
Configure identification as early as possible in your setup, ideally right after [installing the snippet](https://help.usejimo.com/docs/getting-started/install-jimo.md). The earlier you [identify users](https://help.usejimo.com/docs/for-developers/for-developers/sdk-guides/identify-users.md), the more data Jimo accumulates for targeting and analytics.
{% endhint %}

For implementation details, see the [SDK segmentation guide](https://help.usejimo.com/docs/for-developers/for-developers/sdk-guides/setup-the-segmentation.md). If you use a CDP or CRM, check [HubSpot](https://help.usejimo.com/docs/integrations/hubspot.md), [Segment](https://help.usejimo.com/docs/integrations/segment.io.md), or [Salesforce](https://help.usejimo.com/docs/integrations/salesforce.md) to automate attribute syncing.

***

### How Users & Segments connects to Jimo

<details>

<summary><strong>Experience targeting (Who)</strong></summary>

Every experience has a [Who](https://help.usejimo.com/docs/publish/target-right-people-who.md) section in Target & Publish. Select a saved segment or build conditions on the fly. Both use the same condition builder.

</details>

<details>

<summary><strong>Content personalization</strong></summary>

User attributes are accessible as dynamic variables in the [content builder](https://help.usejimo.com/docs/build/builders.md) (e.g. "Hello {firstName}"). Combined with [Multiple Languages](https://help.usejimo.com/docs/build/multiple-languages.md), you can create contextual variants of a single experience.

</details>

<details>

<summary><strong>Analytics and measurement</strong></summary>

Experience [analytics](https://help.usejimo.com/docs/analyze/analytics.md) can be read for one population at a time, through your assistant. The [Success Tracker](https://help.usejimo.com/docs/analyze/success-tracker.md) measures adoption by cohort, answering questions like "Did paying users adopt this feature faster than trial users?"

</details>

<details>

<summary><strong>Automation and triggers</strong></summary>

[Triggers & Conditions](https://help.usejimo.com/docs/build/triggers-and-conditions.md) use attributes and events to fire experiences at the right moment.

</details>

***

## Getting started

{% stepper %}
{% step %}

#### Identify your users

Push `user:id` + `user:email` + `user:name` via the SDK right after login. This is the prerequisite for everything else.

→ [Install Jimo](https://help.usejimo.com/docs/getting-started/install-jimo.md) · [Identify users guide](https://help.usejimo.com/docs/for-developers/for-developers/sdk-guides/identify-users.md)
{% endstep %}

{% step %}

#### Define your key custom attributes

Pick 5-10 attributes that matter for segmentation: plan type, user role, language, creation date, trial status.

→ [Attributes](https://help.usejimo.com/docs/analyze/users-and-segments/data-management/attributes.md) · [Setup the segmentation](https://help.usejimo.com/docs/for-developers/for-developers/sdk-guides/setup-the-segmentation.md) · [Your workspace](https://help.usejimo.com/docs/getting-started/your-workspace.md)
{% endstep %}

{% step %}

#### Create your first segments

Start with 3 to 5 essential groups: new users (created < 7 days), paying users, inactive users (last activity > 30 days), trial users, power users.

→ [Segments](https://help.usejimo.com/docs/analyze/users-and-segments/audience/segments.md)
{% endstep %}

{% step %}

#### Connect your integrations

If you use a CDP or CRM, set up the integration to auto-sync events and attributes.

→ [Integration Setup](https://help.usejimo.com/docs/integrations/integration-setup.md) · [HubSpot](https://help.usejimo.com/docs/integrations/hubspot.md) · [Segment](https://help.usejimo.com/docs/integrations/segment.io.md)
{% endstep %}

{% step %}

#### Iterate

Refine your segments based on [analytics](https://help.usejimo.com/docs/analyze/analytics.md) data and support feedback. Add segments as your adoption strategy matures.
{% endstep %}
{% endstepper %}

<details>

<summary><strong>Practical tips</strong></summary>

* Name segments explicitly: prefer "Paying users, active last 30d" over "Segment 1"
* Do not over-segment early. 5 well-defined segments beat 30 vague ones.
* Use **tags** for manual, one-off categorization. Use **segments** for automated, dynamic targeting.
* Test your segments with the builder preview before applying them to live experiences.
* Use the [Troubleshooting Tool](https://help.usejimo.com/docs/settings/troubleshooting.md) to debug segment membership issues.

</details>

***

## From your assistant

With the [Jimo MCP](https://help.usejimo.com/docs/integrations/mcp/what-to-ask.md) connected, your AI assistant reads this section for you.

> "Which segments exist, how big is each one, and how do Trial Users adopt the onboarding tour compared to everyone?"

It lists the segments with their approximate size, then compares reach and completion per segment against all users, up to five segments at a time. See [What to ask?](https://help.usejimo.com/docs/integrations/mcp/what-to-ask.md).

***

## In this section

<table data-view="cards"><thead><tr><th></th><th data-card-target data-type="content-ref">Go to</th><th data-hidden data-card-cover data-type="files"></th></tr></thead><tbody><tr><td><h4><strong>Audience</strong></h4><p>The people you can reach, and how you group them</p><p><em>· Users</em></p><p><em>· Segments</em></p></td><td><a href="https://help.usejimo.com/docs/analyze/users-and-segments/audience.md">Audience</a></td><td><a href="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2F8EnkV9sumGkzSaEQTKLU%2FD2-c10-audience.png?alt=media&amp;token=4a9b8bb4-4fe3-40ab-b3b2-386645dcd07d">D2-c10-audience.png</a></td></tr><tr><td><h4><strong>Data Management</strong></h4><p>The data your audiences are built on, and how it gets in</p><p><em>· Attributes</em></p><p><em>· Tags</em></p><p><em>· Variables</em></p><p><em>· Imports</em><br><em>· Exports</em></p></td><td><a href="https://help.usejimo.com/docs/analyze/users-and-segments/data-management.md">Data management</a></td><td><a href="https://2794860263-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FKzAcDWQbK1gKbpra7bkb%2Fuploads%2FrKaLLIiksw68CQbH3eHh%2FD2-c13-data-management.png?alt=media&amp;token=b647a234-c9cc-447f-956e-6feb18d9ff45">D2-c13-data-management.png</a></td></tr></tbody></table>

***

### Related pages

* [Who: target the right users](https://help.usejimo.com/docs/publish/target-right-people-who.md): Use segments to control who sees each experience
* [Install Jimo](https://help.usejimo.com/docs/getting-started/install-jimo.md): Snippet installation and user identification setup
* [Setup the segmentation](https://help.usejimo.com/docs/for-developers/for-developers/sdk-guides/setup-the-segmentation.md): Developer guide for custom attributes via the SDK
* [Your workspace](https://help.usejimo.com/docs/getting-started/your-workspace.md): the first step of Getting started
* [Analytics](https://help.usejimo.com/docs/analyze/analytics.md): Experience-level metrics and CSV export
* [Success Tracker](https://help.usejimo.com/docs/analyze/success-tracker.md): In-app event tracking for goal-based measurement
* [Troubleshooting](https://help.usejimo.com/docs/settings/troubleshooting.md): Debug segment membership and experience visibility issues

**Next page:** [Success Tracker](https://help.usejimo.com/docs/analyze/success-tracker.md)
