About
In addition to simple searches, the Virtru Control Center supports advanced searches of sent content (including emails and files). This capability makes it easy for users and admins alike to locate a specific secure email or file in the Control Center to manage or view metadata.
Where possible, the syntax is the same as the advanced search syntax used in Gmail. Users who are already familiar with search in Gmail can immediately use search in Virtru with a minimal learning curve.
Search Syntax
The table below documents the advanced search operators and accompanying examples.
| Operator | Definition | Example |
| from | Search for secure emails and files sent by a specific email address (lowercase only). | Example: from:bob@example.com
Meaning: secure emails from Bob Meaning: secure emails from any user in the organization whose email begins with dan. |
| to | Search for secure emails and files sent to a specific email address (lowercase only). The recipient could have been listed on either the TO, CC, or BCC line. If you are an admin, then the email could be sent by you or anyone else. If you are not an admin, then you will only see emails sent by you. |
Example: to:bob@example.com
Meaning: secure emails sent to Bob. |
| subject | Search for secure emails by subject. | Example: to:bob@example.com AND subject:password
Meaning: secure emails sent to Bob which also have the word “password” in the subject. Meaning: secure emails which have any of the words “credit”, “card”, or “cc” in the subject |
| filename | Search for secure files by filename or type. | Example: filename:screenshot.png
Meaning: secure files with the filename “screenshot.png”. Meaning: secure files which are PDF files. |
| expirationDate | Search for secure emails and files based on the expiration date using the format YYYY-MM-dd. The search results may not show the expiration date, so click on a search result to view the complete detail view. |
Example: expirationDate:2015-05-16
Meaning: Secure emails or files set to expire on May 16, 2015. Meaning: Secure emails or files with an expiration date in the year 2015. |
| is:active | Search for secure emails and files which currently have an active status (they are not expired or revoked). | Example: from:bob@example.com AND is:active
Meaning: Secure emails or files sent by Bob which are currently active. |
| is:revoked | Search for secure emails and files which currently have a revoked status (they are not active or expired). | Example: from:bob@example.com AND is:revoked
Meaning: Secure emails or files sent by Bob which are currently revoked (access to all recipients has been revoked). |
| was:forwarded | Search for secure emails and files which were forwarded by a recipient. Clicking on a search result to view the detail pane will show the forward log. | Example: from:bob@example.com AND was:forwarded
Meaning: Secure emails or files sent by Bob which have been forwarded. |
| has:expiration | Search for secure emails and files which currently have an expiration date set. | Example: from:bob@example.com AND has:expiration
Meaning: Secure emails or files sent by Bob which also have an expiration date set. |
| has:attachment | Search for secure emails which also have an attachment. | Example: from:bob@example.com AND has:attachment
Meaning: Secure emails sent by Bob which also have an attachment. |
| dateSent | Search for secure emails based on the date it was sent using the format YYYY-MM-dd. | Example: dateSent:2015-05-16
Meaning: Secure emails or files sent on May 16, 2015. Meaning: Secure emails or files sent in the year 2015. |
| AND | Search for secure emails or files with multiple required criteria. Note that AND must be capitalized. |
Example: subject:password AND has:attachment
Meaning: Secure emails which contain “password” in the subject and also have an attachment. |
| OR | Search for secure emails or files 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: subject:password OR has:attachment
Meaning: Secure emails which contain “password” in the subject or have an attachment. Meaning: Secure emails which contain “review” in the subject or were sent from an email address starting with “bob”. |
| NOT | Search for secure emails or files where certain criteria must not be true.
The NOT operator cannot be used with just one term. Note that NOT must be capitalized. |
Example: subject:password NOT has:attachment
Meaning: Secure emails which contain “password” in the subject and do not have an attachment. Meaning: NOT cannot be used with one term so this query will return zero results. |
| “ “
(quotes) |
Search for secure emails and files with an exact phrase. | Example: subject:”credit card”
Meaning: Secure emails with the two words “credit card” in the subject. |
| *
(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: from:b*
Meaning: Secure emails from any user whose email address starts with the letter “b”. Meaning: Wildcard cannot be used as the first character in a search. This results in an error. |
| ( )
(parentheses) |
Used to group clauses to form subqueries. 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: from:bob@example.com AND (to:dan* OR to:alice*)
Meaning: Secure emails from Bob which were sent to either Dan or Alice. Example: from:bob@example.com AND (to:dan* OR to:alice*) Meaning: Secure emails from Bob which were sent to either Dan or Alice. |
Virtru search is based on Lucene. Advanced users can read more about the general Lucene query syntax here.