> For the complete documentation index, see [llms.txt](https://docs.maiagent.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-en/org/group-member-filtering.md).

# Role Member Filtering

### Feature Overview

The role member filtering feature allows organization administrators to quickly filter the member list by role, significantly improving member management efficiency in large organizations. With this feature, you can quickly find members with a specific role and perform batch operations or permission adjustments.

{% hint style="info" %}
This feature is especially useful for organizations with multiple roles and a large number of members, effectively simplifying the member management workflow.
{% endhint %}

***

### Using the Filtering Feature

#### Basic Filtering

1. **Navigate to the member management page**
   * Click "<mark style="color:blue;">Organization Settings</mark>" in the left menu
   * Click "<mark style="color:blue;">Organization Overview</mark>"
   * Click "<mark style="color:blue;">Edit Members</mark>"
2. **Select filter criteria**
   * Find the "<mark style="color:blue;">Filter by Role</mark>" dropdown above the member list
   * Select the role to filter by
   * The member list will update immediately, showing only members with that role

#### Filter Options

<table><thead><tr><th width="200">Filter Option</th><th>Description</th></tr></thead><tbody><tr><td><strong>All Members</strong></td><td>Display all members in the organization (default option)</td></tr><tr><td><strong>Owner Role</strong></td><td>Show only members with the owner role</td></tr><tr><td><strong>Default Role</strong></td><td>Show members with only the default role (no other roles assigned)</td></tr><tr><td><strong>Custom Roles</strong></td><td>Filter by custom role names you created<br>(e.g., Marketing, Customer Service, R&#x26;D Team, etc.)</td></tr></tbody></table>

***

### Advanced Operations

#### Combining Filters and Search

You can combine role filtering with keyword search to more precisely find target members:

1. First select a role filter (e.g., "Customer Service")
2. Then enter a member name or email in the search box
3. The system will further search within the filtered results

**Example**:

```
Filter criteria: Customer Service
Search keyword: Wang
→ Result: All members in Customer Service whose name contains "Wang"
```

***

### Use Cases

#### Scenario 1: Building a New Project Team

**Need**: The company is launching a new project and needs to select suitable candidates from existing members to form a project team

**Workflow**:

1. Create a new role "Project A Team"
2. Filter by relevant departments in sequence:
   * Filter "R\&D" → Find 3 engineers
   * Filter "Design" → Find 2 designers
   * Filter "Marketing" → Find 1 marketing specialist
3. Add the selected members to the "Project A Team" role
4. Configure the AI assistant and knowledge base permissions required for the project

#### Scenario 2: Periodic Permission Review

**Need**: Review each department's member permissions quarterly to ensure compliance with the principle of least privilege

**Workflow**:

1. Filter by each department role one by one
2. Check each member's permission configuration:
   * Are there any unnecessary permissions?
   * Are any required permissions missing?
3. Record members that need adjustments
4. Make permission adjustments

#### Scenario 3: Revoking Permissions for Departing Employees

**Need**: An employee is leaving the company, and all their permissions need to be revoked quickly

**Workflow**:

1. Search for the employee's name
2. View all roles the employee belongs to
3. Navigate to the member list for each role
4. Use filtering to quickly locate the employee
5. Remove the employee from all roles
6. Confirm the employee only has the default role (minimum permissions)

***

### Filtering Performance Optimization

#### Recommendations for Large Organizations

If your organization has more than 100 members, consider the following:

1. **Clear role naming**
   * Use clear naming conventions (e.g., Department-Function-Project)
   * Example: "Sales-Customer Service-VIP Project"
2. **Reasonable number of roles**
   * Avoid creating too many granular roles
   * Keep the number of roles per organization to 20 or fewer
3. **Regular cleanup**
   * Delete roles that are no longer in use
   * Remove departed employees
   * Merge roles with similar functions
4. **Leverage batch features**
   * Use Excel batch management (see: [Batch Member and Permission Management](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/blob/main/en/org/bulk-role-permission.md))

***

### FAQ

#### Q: If a member belongs to multiple roles, which filter results will they appear in?

**A**: The member will appear in the filter results for all roles they belong to. For example, if Xiao Wang belongs to both "Marketing" and "Project A," they will appear when filtering by either role.

#### Q: Can filter criteria be saved?

**A**: Saving filter criteria is not currently supported. However, the browser will remember your most recent filter selection and automatically apply it the next time you open the page.

#### Q: Why can't I see certain roles in the filter options?

**A**: Possible reasons:

* You do not have management permissions for that role
* The role has been deleted
* You are not the organization owner (some roles are only visible to owners)

#### Q: What should I do if filtering is slow?

**A**: Possible causes and solutions:

* **Too many members** (>500): Use more precise search criteria
* **Too much browser cache**: Clear the browser cache and try again
* **Network latency**: Check your network connection

***

### Related Features

{% hint style="info" %}
**Related Features**

* [Organization and Member Management](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/blob/main/en/org/rbac.md)
* [Role Permission Management](/maiagent-user-guide/maiagent-user-guide-en/org/role-permission.md)
* [Batch Member and Permission Management](https://github.com/Playma-Co-Ltd/maiagent-user-guide-gitbook/blob/main/en/org/bulk-role-permission.md)
* [Role Resource Access Permissions](/maiagent-user-guide/maiagent-user-guide-en/org/group-resource-access.md)
  {% endhint %}


---

# 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 dynamically by asking a question.

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

```
GET https://docs.maiagent.ai/maiagent-user-guide/maiagent-user-guide-en/org/group-member-filtering.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.