# Searching users

## Quick search

This feature allows you to search a user based on their specific parameter.

To quick search for a specific user,

1\.    From the **Studio** dropdown list in the menu bar, click **Manage users**. The **User Lists** screen is displayed.

<figure><img src="https://4216568905-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mc6E3BSGr4i8kVdH38k%2Fuploads%2FgAgmFqRQZAK67wdHk9yB%2Fsearch.png?alt=media&#x26;token=4fdfe7e5-0bd3-4ea4-97ac-4a15019545a1" alt=""><figcaption></figcaption></figure>

2\.    From **User Lists**, select the user list name from which you want to search for the user.

3\.    In the parameter dropdown, select the parameter by which you want to search the user.

![](https://4216568905-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mc6E3BSGr4i8kVdH38k%2F-MklsKhuawnkH8kGdYoc%2F-Mkm49bDR6s8EfrPCvPJ%2Fimage.png?alt=media\&token=1404b6ff-f1fd-40c6-9fff-a25e3aad44df)

Let's say we want to search for the user by their email address. So we will select **Email** as the search parameter.

4\.    In the **Search** field, enter the value of the parameter selected in step 3 and then click <img src="https://4216568905-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mc6E3BSGr4i8kVdH38k%2F-MklsKhuawnkH8kGdYoc%2F-Mkm6EQBE_liY-z2QIQA%2Fimage.png?alt=media&#x26;token=28edc141-0900-4857-98bd-925dd6ee5c31" alt="" data-size="line"> . \
Since we selected email as the parameter, we will enter the email address of the user in the **Search** field.

The user with the entered value for the parameter is displayed in the user list.

<figure><img src="https://4216568905-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mc6E3BSGr4i8kVdH38k%2Fuploads%2FCbpFLJEBELZegIfe3BLe%2Fsearch.gif?alt=media&#x26;token=1f119093-bd61-49c4-8365-0fe35d7be598" alt=""><figcaption><p><em>Search Users by email</em></p></figcaption></figure>

## Search using filter

This feature allows you to search for users based on a condition.

To search users based on a condition,

1\.    From the **Studio** dropdown list in the menu bar, click **Manage users**. The **User Lists** screen is displayed.

<figure><img src="https://4216568905-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mc6E3BSGr4i8kVdH38k%2Fuploads%2FZAMAFKAjE8tZK03zuGtb%2Ffilter.png?alt=media&#x26;token=42aa9d6f-3502-41eb-97df-65020810395c" alt=""><figcaption><p><em>Filter option</em></p></figcaption></figure>

2\.    From **User Lists**, select the user list name from which you want to search for the user.

3\.    To insert a condition to search the user, on the top right of the screen, click <img src="https://4216568905-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-Mc6E3BSGr4i8kVdH38k%2F-MkmAKHGsSc17kF4Ge6G%2F-MkmENedDoJlYXKaUXDB%2Fimage.png?alt=media&#x26;token=e01c49dc-66b4-441f-adb3-005db593b358" alt="" data-size="line"> . The **Choose Filter** screen is displayed.

4\.    To select the parameter(s) based on which you want to add a condition, click **Select Fields**. The list of parameters is displayed.

5\.    From the list of parameters, select one or more parameters based on which you want to add a

condition and then, at the bottom of the parameter list, click **Apply**.

> Let's say we want to add a condition based on 1 parameter, **Name** to search the user. Thus we have selected **Name** from the list of parameters as shown in the above image.

The selected parameter are displayed on the **Choose Filter** screen.&#x20;

6\.    For a given parameter, click **Select operator and value** and then click **Select operator**.

> Let's say for the **Name** parameter, we select the operator **CONTAINS**. On selection of the operator, a text field is displayed.

7\.    In the text field, enter the value that the parameter in the user list is to be compared with and then at the bottom right of the **Choose Filter** screen, click **Apply**.&#x20;

> Let's say we enter the value as '**a'** as given below.

<figure><img src="https://4216568905-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mc6E3BSGr4i8kVdH38k%2Fuploads%2Fh5wA2WCdzz63PoqlWc11%2Ffilter%20gif.gif?alt=media&#x26;token=ca4348d7-7058-413c-9d64-599b6837bc94" alt=""><figcaption><p><em>Filter Users</em></p></figcaption></figure>

The user(s) that satisfy the conditions added for the parameters are displayed in the user list.

<figure><img src="https://4216568905-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-Mc6E3BSGr4i8kVdH38k%2Fuploads%2FEBClA5RzPrUdvcAAQTgA%2FGroup%2019060.png?alt=media&#x26;token=4e8b5a5d-3646-41a3-bfae-35e03ff600b9" alt=""><figcaption><p><em>Filtered Users</em></p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

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

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.senpiper.com/user-management/managing-users/more-actions/searching-users.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
