Deployed cc1cea5 with MkDocs version: 1.6.1

I version 2.x/entities/users/index.html

@@ -95,6 +95,8 @@
     </li>
     <li class="toctree-l3"><a class="reference internal" href="#query">Query</a>
     </li>
+    <li class="toctree-l3"><a class="reference internal" href="#query-with-roles">Query with Roles</a>
+    </li>
     <li class="toctree-l3"><a class="reference internal" href="#create-new-user">Create new User</a>
     </li>
     <li class="toctree-l3"><a class="reference internal" href="#update-user">Update User</a>
@@ -204,6 +206,16 @@ <h2 id="query">Query</h2>
 queryBuilder.Before = DateTime.Now;
 var users = await client.Users.QueryAsync(queryBuilder);
 </code></pre>
+<h2 id="query-with-roles">Query with Roles</h2>
+<p>To retreive users with roles, you'll need to set the <code>Context</code> property of the <code>UsersQueryBuilder</code> to <code>Context.Edit</code>.</p>
+<pre><code class="language-C#">UsersQueryBuilder queryBuilder = new()
+{
+    // required for roles to be loaded
+    Context = Context.Edit
+};
+
+List&lt;User&gt; users = await _clientAuth.Users.QueryAsync(queryBuilder, true);
+</code></pre>
 <h2 id="create-new-user">Create new User</h2>
 <pre><code class="language-C#">// returns created user
 var user = new User(&quot;username&quot;,&quot;email&quot;,&quot;password&quot;)

index.html

@@ -367,5 +367,5 @@ <h2 id="contribution-guidelines">Contribution Guidelines</h2>
 
 <!--
 MkDocs version : 1.6.1
-Build Date UTC : 2024-09-22 14:18:46.189322+00:00
+Build Date UTC : 2024-09-22 19:43:58.524805+00:00
 -->