Title: User List
Locale: en
URL: https://sensorswave.com/en/docs/user-operation/user-list/
Description: Learn how to view and filter user lists for user-level data exploration
User List provides display and filtering capabilities for user attribute lists, helping you drill down from macro-level data to specific users for user-level data exploration and analysis.

User List supports multiple access entry points, allowing you to enter from different scenarios: directly through the Users menu, by drilling down from analytics model results, or by viewing specific users from a cohort. Regardless of the entry point, you can flexibly filter, view, and operate on user data.

## Access Entry Points

### 1. Users Menu Entry

Directly browse and filter all users:

1. Click **Users** in the left navigation bar
2. Select **User List**
3. By default, the most recently active users are displayed

### 2. Analytics Model Drill-down

Drill down from Segmentation, Funnel Analysis, and other model results to the user list:

**Drill down from Segmentation**:

1. In Segmentation, use **Unique Users** as the aggregation
2. In the data table, click a value
3. The system redirects to User List with filter conditions automatically applied

**Drill down from Funnel Analysis**:

1. In Funnel Analysis, view the converted or dropped-off users at a step
2. Click the **View Users** button
3. The system redirects to User List, displaying the users for that step

**Drill down from Retention Analysis**:

1. In Retention Analysis, click a cell in the retention table
2. The system redirects to User List, displaying the users for that retention period

### 3. Cohort Drill-down

View specific users from a cohort:

1. Navigate to the **Cohorts** page
2. In the cohort list, click a cohort name or the **View Users** button
3. The system redirects to User List, automatically filtered to the cohort's users

## User List Display

### Default Columns

The user list displays the following information by default:

| Column | Description |
|--------|-------------|
| **SSID** | The user's unique identifier; click to enter User Profile |
| **Login ID** | The user's Login ID; click to enter User Profile |
| **Last active time** | The last time the user triggered an event |
| **First Seen** | The first time the user visited the product |

### Custom Column Configuration

You can customize the displayed columns based on your analysis needs:

1. Click the **Column Configuration** button in the top right of the table
2. In the pop-up panel:
   - Check the user properties you want to display
   - Drag to adjust column order
   - Set column width
3. Click **Confirm** to apply the configuration

**Common custom columns**:

- **User properties**: Membership level, registration channel, region, device type, etc.
- **Statistical metrics**: Cumulative spending, order count, active days, etc.
- **Time properties**: Registration time, first payment time, etc.

> **Tip**: Custom column configurations are saved to your account and automatically applied on your next visit.

### List Sorting

Sort by any column:

1. Click a column header to toggle ascending/descending order
2. The currently sorted column displays a sort icon
3. Default sort: **Last active time** descending

## Filter Conditions

User List supports three types of filter conditions that can be combined.

### User Property Filter

Filter based on user property values:

1. Click the **Add Filter** button
2. Select **User Property**
3. Select the property name, e.g., "Membership Level"
4. Select the operator and value, e.g., "Equals Gold Member"

**Supported operators**:

| Operator | Applicable Types | Description |
|----------|-----------------|-------------|
| Equals / Not equals | All types | Exact match of a value |
| Contains / Not Contains | String | Fuzzy match |
| In / Not in | All types | Match any value from a list |
| Greater than / Less than / Between | Numeric, Date | Range filter |
| Is Not Null / Is Null | All types | Check whether the property exists |

**Examples**:

- Membership Level **Equals** Gold Member
- Registration time **Between** 2025-01-01 and 2025-12-31
- Phone number **Is Not Null** (filter users with linked phone numbers)

### User Behavior Filter

Filter based on user behavioral metrics:

1. Click the **Add Filter** button
2. Select **User Behavior**
3. Select the event name, e.g., "Payment Successful"
4. Select the aggregation method, e.g., "Total count" or "Sum of property values"
5. Set the time range, e.g., "Past 30 days"
6. Set the condition, e.g., "Greater than 3"

**Supported aggregation methods**:

- **Total count**: Number of times the event occurred
- **Sum of property values**: Sum of event property values
- **Average of property values**: Average of event property values
- **Distinct count of property**: Number of distinct property values

**Examples**:

- Past 7 days **Browse Product** count **Greater than** 10
- Past 30 days **Payment Successful** Order Amount sum **Greater than** 500
- Past 30 days **Search** search term distinct count **Greater than** 5

### Cohort Filter

Filter using existing cohorts:

1. Click the **Add Filter** button
2. Select **Cohort**
3. Select the operation: **Belongs to** or **Does not belong to**
4. Select one or more cohorts

**Examples**:

- **Belongs to** "High-Value Users" cohort
- **Does not belong to** "Churned Users" cohort
- **Belongs to** "VIP Users" AND **Does not belong to** "Refunded Users"

### Combining Filter Conditions

Multiple filter conditions support "AND" and "OR" combinations:

**AND relationship**: Users who meet all conditions

```
Membership Level = Gold Member AND Spending in the past 30 days > 1000
```

**OR relationship**: Users who meet any condition

```
Membership Level = Gold Member OR Membership Level = Platinum Member
```

**Nested combination**:

```
(Membership Level = Gold Member OR Membership Level = Platinum Member) AND Active in the past 30 days
```

## User Operations

### View User Details

Click a user ID in the user list to navigate to the User Profile page:

1. Click the **User ID** link on a user row
2. Or click the **View Details** button at the end of the row
3. Enter the User Profile page

See [User Profile](user-profile.mdx) for details.

### Batch Select Users

You can batch-select users for operations:

1. Check the checkbox before a user row to select a single user
2. Check the header checkbox to select all users on the current page
3. Click **Select all matching users** to select all users

### Save as Cohort

Save the current filter results as a cohort:

1. Configure filter conditions to select target users
2. Click the **Save as Cohort** button in the top right corner
3. Select the cohort type:
   - **Static Cohort**: Save a snapshot of the current users; no further updates
   - **Dynamic Cohort**: Save filter rules; users are automatically updated
4. Fill in the Cohort Name and description
5. Click **Confirm** to save

> **Tip**: If the filter conditions include behavior filters or cohort filters, we recommend using a Dynamic Cohort so users are automatically updated.

### Export User List

Export the user list as a file:

1. Configure filter conditions and display columns
2. Click the **Export** button in the top right corner
3. Select the export format: CSV or Excel
4. Select the export scope: Current page or all users
5. Click **Confirm** to start exporting

**Export limits**:

- Maximum of 100,000 records per export
- When exceeding the limit, narrow the filter scope or export in batches

## Usage Scenario Examples

### Scenario 1: Anomalous Metric Investigation

Discovered an unusual drop in paying users on a specific day:

1. In Segmentation, drill down from the anomalous date's data point to User List
2. View the paying user list for that date
3. Add User Property filters to analyze by different dimensions (platform, channel, region)
4. Identify the user group where the anomaly is concentrated
5. Click a specific user to view their Activity and locate the issue

### Scenario 2: User Profile Analysis

Understand the characteristics of highly active users:

1. Add behavior filter: Active days in the past 7 days > 5
2. Customize display columns: Add registration channel, membership level, cumulative spending, etc.
3. Observe the property distribution of highly active users
4. Save the results as a cohort for subsequent analysis

### Scenario 3: Customer Support

A user reported an issue and needs troubleshooting:

1. Search for the user by ID or phone number in User List
2. Click to enter the User Profile
3. View the user's Activity to locate the time the issue occurred
4. Check the user's Feature Gate status and Experiment participation
5. Provide findings to the technical team

### Scenario 4: Targeted User Outreach

Need to find users matching specific conditions for operations:

1. Add multiple filter conditions to define target users
2. Review the estimated user count and evaluate the scale
3. Save as a cohort
4. Export the cohort for use in SMS/push notification or other external outreach systems

## Notes

### Performance Optimization

- The more filter conditions, the longer the query takes. Keep the number of conditions reasonable
- The larger the time range for behavior filters, the slower the query. Prefer shorter time ranges
- Loading a large user list may be slow. Add filter conditions first to narrow the scope

### Data Accuracy

- User list data may have a 1–5 minute delay
- Dynamic Cohort sizes change over time; the list displays results as of the current moment
- Exported data is a snapshot at the time of export

### Permissions

- Viewing User List requires access to the Users module
- Saving a cohort requires "Create Cohort" permission
- Exporting user lists requires "Data Export" permission

## Next Steps

Now that you understand how to use User List, you can:

1. **[User Profile](user-profile.mdx)**: Learn more about individual user profiles
2. **[Cohorts Overview](cohort-overview.mdx)**: Learn how to create and manage cohorts
3. **[Integration with Analytics](integration-with-analytics.mdx)**: Master drill-down and cohort saving techniques

---

**Last updated**: January 19, 2026