Resources

Product Support & FAQ

How do I search for users in the Virtru Dashboard?

The Virtru Dashboard allows users to control the access policies for all of their secure emails and attachments. Administrators can see which secure emails have been sent throughout their entire organization. The advanced search capability makes it easy to locate a specific user or set of users, which administrators can manage.

Where possible, the syntax is the same as the advanced search syntax used in Gmail so that users who are already familiar with search in Gmail can immediately use search in Virtru with minimal learning curve.

The table below documents the advanced search operators and accompanying examples.

OperatorDefinitionExample
emailSearch for users with a specific email address.Example: email:bob@example.com

Meaning: The user whose email matches “bob@example.com” exactly.

Example: email:dan*

Meaning: any user in the organization whose email begins with dan.

statusSearch for users with a specific status.Example: status:active, status:pending, or status:revoked

Meaning: Users who have a specific status.

Note: Right now all users are considered to have an active status. This will be changed in a future update.

is:activated

has:activated

Search for users who have activated on any platform other than Secure Reader or Dashboard. This means that they are completely set up to send and receive secure email messages.Example: email:bob@example.com AND is:activated or has:activated

Meaning: Users who have a specific activation status.

Note: Right now all users are considered to have an active status. This will be changed in a future update.

is:adminSearch for users with administrative rights.Example: is:admin

Meaning: Users who are admins.

ANDSearch for users with multiple required criteria.Note that AND must be capitalized.Example: email:s* AND has:activated

Meaning: users whose email addresses start with “s” and are fully activated.

ORSearch for users with multiple optional criteria.This is the default behavior for a search query if no boolean logic is specified. Note that OR must be capitalized.Example: email:s* OR email:l*

Meaning: Users whose email addresses start with either “s” or “l”.

NOTSearch for users where certain criteria must not be true.The NOT operator cannot be used with just one term. Note that NOT must be capitalized.Example: NOT email:b*

Meaning: users whose email does not start with “b”.

“ ”(quotes)Search for users with an exact phrase.Example: email:“mike@example.com”

Meaning: users whose email address exactly matches “mike@example.com”. This search will omit results such as mikethompson@example.com or mikejefferson@email.com because they don’t match the query exactly.

*(asterisk)The wildcard character looks for 0 or more characters in a term.

Note: You cannot use a * or ? symbol as the first character of a search.

Example: email:b*Meaning: Users whose email addresses starts with the letter “b”.

Example: email:*@example.com

Meaning: Wildcard cannot be used as the first character in a search. This results in an error.

( )(parentheses)Used to group clauses to form sub queries. This can be very useful if you want to control the boolean logic for a query.Used to group multiple clauses to a single field.Example: email:a*@example.com AND (is:activated OR status:pending)

Meaning: Users whose email address starts with “a” and are either activated or have a pending status.

Virtru search is based on Lucene and advanced users can read more about the general Lucene query syntax here.

The Virtru Dashboard allows users to control the access policies for all of their secure emails and attachments. Administrators can see which secure emails have been sent throughout their entire organization. The advanced search capability makes it easy to locate a specific user or set of users, which administrators can manage.