> For the complete documentation index, see [llms.txt](https://docs.realmjoin.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.realmjoin.com/ugd-management/user-list.md).

# User, Group and Device Lists

Search and browse users, groups, and devices, and open any object's details page from RealmJoin Portal.

{% embed url="<https://www.youtube.com/watch?v=IlIEnhoaaIA>" %}
Video tutorial (shows an older version of the lists)
{% endembed %}

Selecting the Users, Groups or Devices tab lists the users, groups and devices of your tenant. Click the name of an object to open its details page.

### Object Types

User, Group and Device object types are separated in the same manner as Entra ID:

{% tabs %}
{% tab title="Users" %}
Users include:

* Entra ID user objects
* Entra ID external users, a.k.a. Guests
* Shared mailboxes
* Room and Equipment mailboxes
* Administrative user accounts
  {% endtab %}

{% tab title="Groups" %}
Group objects include:

* Entra ID static and dynamic groups
* Exchange Online mail-enabled groups and distribution groups
* Microsoft Office365 groups and teams
  {% endtab %}

{% tab title="Devices" %}
Devices include:

* Entra ID joined clients, like modern workplace clients
* Entra ID registered devices, like user-owned phones and tablets
* Other devices, like printers used by MS Universal Printing or Surface Hubs
  {% endtab %}
  {% endtabs %}

### Search, Export and Paging

Type into the search box and press Enter to search. RealmJoin Portal first searches Microsoft Graph directly (**Basic search**) and loads a full copy of the list in the background. Once it is ready, the list switches to **Advanced search**, which searches more fields, supports the [advanced search syntax](https://docs.realmjoin.com/analyze-and-export/advanced-search/advanced-search-syntax.md), pages through all results and allows sorting the whole list. The footer of the list shows which mode is active and how old the data is.

In advanced search you can also use:

* **Export** - Downloads all rows matching the current filters and search, with all available fields, as an Excel file
* **Reload** - Refreshes the data

See [Advanced Search](https://docs.realmjoin.com/analyze-and-export/advanced-search.md) for details.

Your filters and search are kept in the page's URL, so you can bookmark or share a filtered list. RealmJoin Portal also remembers them for about an hour when you come back to the list.

### Filters

You can use the filters above the list to limit search results to specific User, Group or Device objects:

{% tabs %}
{% tab title="Users" %}

<figure><img src="https://2868468309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-d66bb24ab45efc6ba3bd25c182877444fcd0e1cf%2Fugd-user-list.png?alt=media" alt="User list with filters and advanced search footer"><figcaption><p>User List</p></figcaption></figure>

**Account state**

* **Any** - Show enabled and disabled users
* **Enabled** - Show only users who can sign in (default)
* **Disabled** - Show only users who are blocked from sign-in

**User Type**

* **Any** - Both Members and Guests are displayed
* **Members** - Users native to your tenant (default)
* **Guests** - Azure B2B Guests invited from other tenants

The list shows each user's name, UPN, object ID, creation date, job title, city, country and type. Disabled users are shown struck through.
{% endtab %}

{% tab title="Groups" %}

<figure><img src="https://2868468309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-238efbe52457c3b4c6a3279940e007dd7974f8f2%2Fugd-group-list.png?alt=media" alt="Group list with filters"><figcaption><p>Group List</p></figcaption></figure>

**Only RealmJoin**

Turn this toggle **off** to include groups that do not match any RealmJoin naming scheme. When **off** all Entra ID groups will be shown.

By default (**on**), RealmJoin only lists groups whose name starts with one of the [group prefixes](https://docs.realmjoin.com/administration-and-settings/groups.md) configured for your tenant, such as

* Licensing Groups ("lic -")
* Application-Assignment Groups ("app -")
* Configuration/Permission Groups ("cfg -")

**Teams**

* **Any** - All groups (default)
* **Teams** - Only groups that are a Team
* **Non-Teams** - Only groups that are not a Team

**Membership Type**

Limit the groups shown to

* **Any** - All groups (default)
* **Static** - Groups with static member assignment
* **Dynamic** - Groups with dynamic membership

**Group Type**

Limit the search results to the type of Entra ID group

* **Any** - All groups (default)
* **Security** - List Security Groups. In basic search this also includes Exchange-related groups like Distribution Lists.
* **Unified** - List Microsoft 365 groups/teams as well as RealmJoin internal groups like "RealmJoin - All Users"

The list shows the group's type badges (**S**ecurity / **U**nified, **S**tatic / **D**ynamic, **T**eams), its name, member count, object ID and whether it is a **RealmJoin** or a **General** group.
{% endtab %}

{% tab title="Devices" %}

<figure><img src="https://2868468309-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MkrcM7cKOpXKri1kVrh%2Fuploads%2Fgit-blob-f37591ccbdc906c83a83a28c7ffb89e1b6611879%2Fugd-device-list.png?alt=media" alt="Device list with filters"><figcaption><p>Device List</p></figcaption></figure>

**Type**

Use this filter to select devices based on their operating system or device type.

* **Any** (default) - Show all devices
* **Desktops** - Show Windows, macOS and Linux devices
* **CloudPC** - Show only Windows 365 Cloud PCs (advanced search only)
* **Mobiles** - Show iOS, iPadOS and Android devices
* **Other** - Show other devices, like Surface Hubs and printers from Universal Print (advanced search only)

**Account state**

* **Any** - Show enabled and disabled devices
* **Enabled** - Show only devices that are enabled in Entra ID (default)
* **Disabled** - Show only devices that are disabled in Entra ID

**Compliance State**

For managed devices, you can choose to limit the results according to their [compliance state](https://docs.microsoft.com/en-us/mem/intune/protect/device-compliance-get-started) in Intune.

* **Any** - Show all devices
* **Compliant** (default) - Show only devices reported as compliant by Intune
* **Non-compliant** - Show only devices reported as not currently compliant by Intune

{% hint style="info" %}
By default the list shows only compliant devices. Select **Any** to also see non-compliant and unmanaged devices.
{% endhint %}

The list shows each device's name, ID, first and last seen dates, RealmJoin Client version, operating system, manufacturer, model, serial number, last Intune sync, owner and compliance. **Last Seen** is based on Entra ID and enhanced with RealmJoin telemetry when available. It is sorted by **Last Seen**, most recent first.
{% endtab %}
{% endtabs %}

### Filtered by Software Report

When you open the user or device list from the [Software Report](https://docs.realmjoin.com/analyze-and-export/software-reporting.md) or from the install counts on an app's details page, the list is limited to the users or devices with that software. A **Filtered by Software Report** badge shows above the list. Click it to remove the filter.


---

# 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://docs.realmjoin.com/ugd-management/user-list.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.
