> For the complete documentation index, see [llms.txt](https://help.smartico.ai/welcome/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smartico.ai/welcome/products/crm-automation/segmentation/user-state-segments.md).

# User State Segments

### Overview

User State Segments evaluate users based on their current profile properties. In real-time campaigns and automations, conditions are checked instantaneously in memory as events occur. In the Back-Office interface, the displayed user count and user list update periodically in the background.

For example, a segment of all users that made 1 deposit, might match 10 users right now but 9 users tomorrow, or in 15 minutes in case these 10 users will make a second deposit.

### How to create a user state segment

1. Go to **Marketing**
2. Open **Segments** (under **Segmentation**)
3. Click **Create**

<div data-with-frame="true"><figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-64a74e6d57982b1db373352190b1a12ffea589ba%2Fr2-088-shot-1-241bdddc-560d6a.png?alt=media" alt=""><figcaption><p>Segments list: 1 — Create; 2 — User state segment</p></figcaption></figure></div>

4. Choose the type of segment. In our case **User state segment**
5. Enter the **Segment name**. The name can indicate the audience you are targeting, such as "VIP Bronze players" or "Canada First Deposit".

<div data-with-frame="true"><figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-efa1a7c0258268ca1134eb5651b8f75c691e6500%2Fr2-089-shot-2-b4132140-47930d.png?alt=media" alt=""><figcaption><p>Core setup of a new user state segment: 1 — Segment name; 2 — Search keywords; 3 — Advanced settings</p></figcaption></figure></div>

6\. Add conditions to your Segment to slice the population to your goals based on financial, behavioral, demographic, or gamification properties.

7\. Click **Estimate** under **Audience size** to see how many users fit the group of conditions you have created, then save the Segment.

### Segment Settings and Lifecycle

Under **Advanced settings** in the segment setup, you can configure:

* **Keep active, even if not in use**: Prevents the segment from being automatically archived after 30 days of inactivity.
* **Allow segment export from DWH**: Enables exporting the segment user list directly via Data Warehouse queries.

In **Core setup**, the **Search keywords** field lets you add tags to easily organize and locate your segments.

<div><figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-a9de8f5c812890d8a738315fa4786d72045ca0cc%2Fr2-086-crop-3-202cd2ca-06059a.png?alt=media" alt=""><figcaption></figcaption></figure> <figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-1511a78952034182876e5b7aa10c79694618a1a5%2Fr2-087-crop-4-39596f0e-51718c.png?alt=media" alt=""><figcaption></figcaption></figure></div>

### Combining Conditions and Nested Segments

* **AND vs. OR Groups**: By default, multiple conditions are combined with AND logic (users must match all conditions). You can add **OR groups** (sub-groups) to qualify users who meet any one of several alternate conditions.
* **Label Scope vs. Brand Scope**: Segments apply across the entire label. If your label operates multiple brands, add an explicit Brand condition to restrict the segment to a specific brand.
* **Segment Nesting**: You can filter by other segments with the properties **Core: State based segments** (other user state segments), **Core: Behavioural segments**, and **Core: CSV & Common case segments**. This combines state criteria with Behavioral, CSV or Common Cases segments.
* For full operator and query builder documentation, see [Query Builder](https://help.smartico.ai/welcome/products/crm-automation/segmentation/query-builder.md).

You can see the current users of the segment in the **Users List** tab:

<div data-with-frame="true"><figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-85aacd8c0a7f9080f0f2b92f606b9400990435b1%2FScreenshot_24.png?alt=media" alt=""><figcaption></figcaption></figure></div>

You can also check all the places where the segment is being used under the **Segment usage** tab.

### Additional Segment Features and Actions

* **Export CSV**: Click the download icon (**Export Segment**) in the top right corner of the segment to download matching users as a CSV file. You can run a one-time export or schedule a recurring export (e.g. daily or weekly).
* **Segment dynamic** tab: View historical trends and size changes of the segment over time.
* **Lock Segment Snapshot**: To freeze the current audience of a User State Segment into a fixed list, create a Common Cases segment using the **Lock User State Segment** template. See ["Common Cases" Segments](https://help.smartico.ai/welcome/products/crm-automation/segmentation/common-cases-segments.md).

<div data-with-frame="true"><figure><img src="https://77049817-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FfS5hl0PiysHtKAKMsQTe%2Fuploads%2Fgit-blob-fab16c90565da9bc4b60318d8fe6d386e8f01e78%2FScreenshot_25.png?alt=media" alt=""><figcaption></figcaption></figure></div>

### Frequently Asked Questions

**Why don't users appear immediately in the User List tab after an action?**

In real-time campaigns, segment qualification happens instantaneously in memory. However, the Back-Office user list and count are refreshed through background warehouse calculations that update periodically.

**How should I configure a first-time action segment for a real-time journey?**

Because journey conditions are checked immediately after the event is processed, a real-time campaign triggered on first deposit should check for a total deposit count of 1, not 0.

**Can I export segment users automatically on a schedule?**

Yes. In the Export Segment window, toggle **Setup recurring export** and choose a daily, weekly, or monthly schedule. You will receive an email and push notification when each file is ready.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.smartico.ai/welcome/products/crm-automation/segmentation/user-state-segments.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
