blob: ce081f9bf2b90f0723557094c0b9d2dc73fe1d7c [file] [log] [blame] [view]
---
title: " Gerrit Code Review - Searching Groups"
sidebar: gerritdoc_sidebar
permalink: user-search-groups.html
---
Group queries only match internal groups. External groups and system
groups are not included in the query result.
## Basic Group Search
Similar to many popular search engines on the web, just enter some text
and let Gerrit figure out the meaning:
<table>
<colgroup>
<col width="50%" />
<col width="50%" />
</colgroup>
<thead>
<tr class="header">
<th>Description</th>
<th>Examples</th>
</tr>
</thead>
<tbody>
<tr class="odd">
<td><p>Name</p></td>
<td><p>Foo-Verifiers</p></td>
</tr>
<tr class="even">
<td><p>UUID</p></td>
<td><p>6a1e70e1a88782771a91808c8af9bbb7a9871389</p></td>
</tr>
<tr class="odd">
<td><p>Description</p></td>
<td><p>deprecated</p></td>
</tr>
</tbody>
</table>
## Search Operators
Operators act as restrictions on the search. As more operators are added
to the same query string, they further restrict the returned results.
Search can also be performed by typing only a text with no operator,
which will match against a variety of fields.
- description:'DESCRIPTION'
Matches groups that have a description that contains *DESCRIPTION*
(case-insensitive).
- inname:'NAMEPART'
Matches groups that have a name part that starts with *NAMEPART*
(case-insensitive).
- is:visibletoall
Matches groups that are in the groups options marked as visible to
all registered users.
- name:'NAME'
Matches groups that have the name *NAME* (case-insensitive).
- owner:'OWNER'
Matches groups that are owned by the group whose name best matches
*OWNER* or that has the UUID *OWNER*.
- uuid:'UUID'
Matches groups that have the UUID *UUID*.
- member:'MEMBER'
Matches groups that have the account represented by *MEMBER* as a
member.
- subgroup:'SUBGROUP'
Matches groups that have a subgroup whose name best matches
*SUBGROUP* or whose UUID is *SUBGROUP*.
## Magical Operators
- is:visible
Magical internal flag to prove the current user has access to read
the group. This flag is always added to any query.
- limit:'CNT'
Limit the returned results to no more than *CNT* records. This is
automatically set to the page size configured in the current users
preferences. Including it in a web query may lead to unpredictable
results with regards to pagination.
## GERRIT
Part of [Gerrit Code Review](index.html)
## SEARCHBOX