---
title: "Use Advanced Search"
slug: "use-advanced-search"
tags: ["Advanced Keyword", "Advanced Search", "data selection", "term list", "Use Advanced Search"]
updated: 2025-08-26T13:30:59Z
published: 2025-08-26T13:30:59Z
canonical: "docs.revealdata.com/use-advanced-search"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://docs.revealdata.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Use Advanced Search

Advanced Search, which is accessed from the button at farthest right in the Search bar, facilitates adding conditions, fields and even lists of terms to a search.

![25 - 01 - Advanced Search open-2](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2001%20-%20Advanced%20Search%20open-2.png?width=1082&quality=high)

1. Log into Reveal and open a project; the account used may be at any permission level.

> [!NOTE]
> Note
> 
> Unless you have the role permission to Allow All Field / Tag Access for Search, your search and Dashboard data visualizations will be limited to those fields and tags that exist in profiles assigned to your teams, or if you are not assigned to a team, to the Default field and tag profiles.
2. The project will open to the Dashboard, but the Search bar will work for any screen.
3. Enter a word, phrase or other term into the Search bar. You will see prompts below with clickable search suggestions, the last of which will always be *Open Builder* for Advanced Search. ![25 - 00 - Search Entry Prompts](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2000%20-%20Search%20Entry%20Prompts.png?width=370&quality=high)
4. Click the **Advanced Search** button (**[...]** at the right edge of the Search bar) to open the Search Builder.
5. The initial search concept is shown as a "pill", which may be clicked to edit (here, as a [***Concept Search***](/reveal/docs/search-concepts)) or removed by clicking the **X** at the right of the pill.

> [!NOTE]
> Note
> 
> *A search entered originally as a Concept Search will first open the Concept Search modal to adjust the concept terms; clicking****Search****from there will place the Concept Search pill in the Search Bar, from where Advanced Search may be opened.*
6. Each search term pill is preceded by a toggle between **IS** or **NOT** to indicate inclusion of exclusion of the searched item.
7. You may specify a Search Profile for a focused metadata search using a selection from the list at the bottom left of the Search Builder screen. ![25 - 01a - Add Search Profile](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2001a%20-%20Add%20Search%20Profile.png?width=174&quality=high)
8. You may add a condition or field under the **+Add** button, or from the quick links for **Term List**, **Keywords**, **Concept**, **Folders** and (in Reveal 11.11 or later projects or project updates) **Communicators**:
  1. Use *Find...* to filter to a field (see 8.c below). ![25 - 02 - Advanced Search Add Condition - Common-3](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2002%20-%20Advanced%20Search%20Add%20Condition%20-%20Common-3.png?width=407&quality=high)
  2. Common:
    1. ***Advanced Keyword*** - Add a keyword or phrase to the search, limitable by metadata search profile if any; the search pill is added with a toggle between **AND****(default)*,*and **OR**. Note that Phrases in Reveal 11 require quotation marks to be interpreted as phrases.

![25 - 03 - Advanced Search Add Condition - Common adv keyword-1](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2003%20-%20Advanced%20Search%20Add%20Condition%20-%20Common%20adv%20keyword-1.png?width=609&quality=high)

> [!NOTE]
> Note
> 
> The curly braces at the right of the Keyword Search entry open a prompt to assist with syntax.

![25 - 03a - Advanced Search Add Condition - keyword assist](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2003a%20-%20Advanced%20Search%20Add%20Condition%20-%20keyword%20assist.png?width=945&quality=high)

You may also use the tilde (“~”) character will open a list of fields that may be selected to set an RQL metadata filter, such as *accountant and FILE_EXTENSION::"xls*"*.

![24 - 01a - Add Keyword Field list](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/24%20-%2001a%20-%20Add%20Keyword%20Field%20list.png?width=607&quality=high)
    2. ***Cluster*** - A group of thematically-related documents may be specified by Cluster ID. This is best used in the Clusters context.
    3. ***Concept*** - A new custom Concept search may be generated in the Concept Search screen opened by this choice which prompts *Enter an Initial Concept to Begin*.
    4. ***Deduplication*** - A search condition mirroring the Candy Bar, allowing the user to select retrieval of documents falling under of any of the following categories:

![25 - 09a - Deduplication type search select pill](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2009a%20-%20Deduplication%20type%20search%20select%20pill.png?width=1073&quality=high)
      1. *Originals*
      2. *Near Duplicate*
      3. *Exact Duplicate*
      4. *Not Analyzed*
    5. ***Folder***- Add a designated collection of documents in a folder of any type found in the Sidebar as a search criterion. **NOTE** that this dialog is also accessible from ***Search Across Folders*** under the **[...]** menu to the right of the **Folders** section of the Sidebar. ![25 - 02a - Advanced Search Add Condition - Folder-1](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2002a%20-%20Advanced%20Search%20Add%20Condition%20-%20Folder-1.png?width=609&quality=high)

> [!NOTE]
> Note
> 
> If a work folder that is part of a Saved Search is later deleted, Reveal will warn of a problem with the folder when asked to run that saved search.
    6. ***Communicators****–*As of Reveal 11.11 (or a previously-created project with AI Sync re-run for Reveal 11.11), you may start a search for a Communicator – a persona that includes multiple email address aliases – using a quick link or an **Add** menu selection in Advanced Search Builder. ![25 - 02b - Advanced Search - Communicators](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2002b%20-%20Advanced%20Search%20-%20Communicators.png?width=1377&quality=high) A Communicator can be selected along with all its defined email aliases and searched through a search filter. The Communicator search filter can also be customized by editing the selection of aliases—simply check or uncheck specific email addresses in the alias list for the current search. Additionally, you can specify whether to view the Communicator only in specific roles, such as "From," "To," "BCC," or "CC."

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/image-PUA2OYWS.png) See [***Communications***](/reveal/docs/communications) for more details on Communicators, aliases and their handling.
    7. ***Grid Indicators***- Add a search for the fixed (Calculated) field categories shown at the left of the Grid as icons. These choices include: ![25 - 09 - Calculated Search options-1](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2009%20-%20Calculated%20Search%20options-1.png?width=609&quality=high)
      1. *File Extension*- will retrieve only documents which have a file extension. Toggling the connector from AND / OR to NOT will look only for documents having no value in the File Extension field.
      2. *Has Tags*- retrieves documents which have at least one tag.
      3. *Has Annotations* - retrieves documents which have at least one Redaction, Sticky Note, Text Text Annotation, Freehand Annotation or Highlight.
      4. *Has Notes* - retrieves documents containing reviewer notes.
      5. *Has Family Members* - retrieves documents having family relationships, such as child or parent documents.
      6. *Has Duplicates* - retrieves documents having exact duplicates with identical hash values.
      7. *Has Near Duplicates* - retrieves documents analyzed as similar to others within a defined threshold.
      8. *Has Email Threads* - retrieves documents that exist within email conversations.
      9. *Has Alerts* - retrieves documents bearing a defined alert.
      10. *Has Locks* - retrieves documents where the admin has disabled some aspect of coding.
    8. **Reviewed** – Filter the search by reviewed status under the User’s Tag Profile.
    9. ***Term List*** - The same **Term List Search** window opens here as for the **Term List** button in the Advanced Search main screen. Terms are connected by a presumed *OR* operator. You may enter either:
      1. Plain Text - enter one term per line or toggle to

![](https://cdn.us.document360.io/3e21d801-ca9f-4c51-93db-9cbd32741f3d/Images/Documentation/term-list-search-plain-text.png)
      2. Table - Click **+Add Term** to enter each line. ![25 - 04 - Advanced Search Add Condition - Term List table-4](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2004%20-%20Advanced%20Search%20Add%20Condition%20-%20Term%20List%20table-4.png?width=1400&quality=high)
        1. You have the option to total each term, or total all entries and net sum of documents and families retrieved by clicking the **>** button at **Totals**. There is a checkbox in the upper right to ***Show project-wide counts***, which will provide complete totals for each term if checked or combine the individual terms in the list with the currently-active search if unchecked (the default).
        2. Terms may be re-ordered using the 6-dot grab handles at the left under the **Sort Order** column.
        3. Each term may be temporarily deselected to determine the value of other terms in the list. ![25 - 04a - Disable a term list item (11_1)-2](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2004a%20-%20Disable%20a%20term%20list%20item%20(11_1)-2.png?width=1400&quality=high)
        4. Each term may be removed using the trash bin at its right.
        5. A Search Syntax Guide provides assistance with operators and regular expression (RegEx) syntax used in formulating more advanced queries. ![25 - 04b - Term List Regex RQL Helper-1](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2004b%20-%20Term%20List%20Regex%20RQL%20Helper-1.png?width=1183&quality=high)
        6. The Term List may be saved as a report.
      3. When either is complete, click **Add To Search**to finish and add a Term pill to the search.
  3. Fields: A list of all fields visible in the current Field Profile that may be selected for advanced search.
    1. You may filter the Fields and other conditions offered using the *Find...* filter.

![25 - 05 - Advanced Search Add Condition - Fields (find)-2](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2005%20-%20Advanced%20Search%20Add%20Condition%20-%20Fields%20(find)-2.png?width=1050&quality=high)
    2. The field filter window opens with a list of operators for your specified filter: *Is* or *Contains*. The selector for that filter covers an *AND<>OR*switch that defaults to AND*.*You may then select any one or more items from the list of field values below, or select documents having either ***Any Value*** (that is, not empty) or ***No Value*** (that is, blank). ![25 - 06 - Advanced Search Add Condition - Field operators-1](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2006%20-%20Advanced%20Search%20Add%20Condition%20-%20Field%20operators-1.png?width=608&amp;quality=high)
    3. Some special operators are associated with Date, Time and DateTime fields. These operators include ***Before, After, Between, On, Days ago***, ***Has Any Value*** and ***Has No Value***. ***Days ago****,*added in Reveal 11.9, facilitates a search for ‘yesterday’ as ***1****day ago* in the example of a search on *Last Reviewed On Date* over a prior calendar day). ![25 - 05a - Adv Search Date Operators](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2005a%20-%20Adv%20Search%20Date%20Operators.png?width=605&amp;quality=high)
  4. Model Scores: Select Classifier model and the scoring value for that model to be applied on a scale from 0 to 100 (with a toggle to *Exclude*), or check if you are looking for documents with *No Score* for this model.
  5. Tags: Available tags may be added as a choice to be searched.
  6. Entities: An entity is an extracted piece of data identified by proper name. Entities are an efficient method for searching (filtering) for specific people, places or things. Any of these object types may be added to a search. For each entity, a screen will present a list of available entities for selection. Categories include:

![25 - 10 - Entity Search options](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2010%20-%20Entity%20Search%20options.png?width=1067&amp;quality=high)
    1. *BRS Has Entity Type*- to determine if a document contains a specified type of entity.
    2. *Entity Credit Card Num*
    3. *Entity Email*
    4. *Entity Location*
    5. *Entity Money*
    6. *Entity Nationality*
    7. *Entity Organization -*here is an example of an entity specification screen; note that ***Any Value*** (documents where some entity organization is found) or ***No Value*** (documents where no entity organization is found) may be selected: ![25 - 11 - Entity Search Organization spec-1](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2011%20-%20Entity%20Search%20Organization%20spec-1.png?width=608&amp;quality=high)
    8. *Entity Person*
    9. *Entity Personal ID Num*
    10. *Entity Phone Num*
    11. *Entity Product*
    12. *Entity Religion*
    13. *Entity Title*
    14. *Entity URL*
  7. IDs: Documents may be retrieved by specifying a control number type - ![25 - 12 - IDs search selection](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2012%20-%20IDs%20search%20selection.png?width=385&amp;quality=high) - and the either entering or uploading a list of ID values. ![25 - 13 - IDs search entry and upload](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2013%20-%20IDs%20search%20entry%20and%20upload.png?width=609&amp;quality=high)
  8. Emotional Intelligence: Emotional Intelligence (also known as "Sentiment") uses natural language processing enhanced with Reveal analytics to assess and score the content of a message. Documents are scored on a scale of 0-10 (0 = neutral, 1 = lowest, 10 = highest), currently for *Intent Score*, *Opportunity Score*, *Negativity*, *Opportunity Score*, *Positivity, Pressure Score, Rationalization Score* or *Roundabout Style Score*. Documents which could not be scored, for reasons of format or content type, may also be retrieved. ![104 - 03 - Emotional Intelligence Positivity search setting](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/104%20-%2003%20-%20Emotional%20Intelligence%20Positivity%20search%20setting.png?width=836&amp;quality=high)
  9. You may add Saved Searches to the Search Builder.
    1. With Search Builder open, click the **Save Search** button.
    2. Click the spyglass next to a saved search to add it to the current search. ![25 - 16 - Add Saved Search to search](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2016%20-%20Add%20Saved%20Search%20to%20search.png?width=716&amp;quality=high)
  10. You may add recent searches from the Search History list to the Search Builder.
    1. With Search Builder open, click the **Search History** button.
    2. Click the spyglass next to a listed search to add it to the current search. ![29 - 02a - Search History item - add to search](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/29%20-%2002a%20-%20Search%20History%20item%20-%20add%20to%20search.png?width=970&amp;quality=high)
  11. The search builder offers click toggles for ***IS / NOT***and ***AND / OR***. Use **Preview result count** to show how many documents will be retrieved by the current advanced search: ![25 - 07 - Advanced Search Preview result count-2](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2007%20-%20Advanced%20Search%20Preview%20result%20count-2.png?width=1462&amp;quality=high)
  12. The order of the Advanced Search may be changed by grabbing the handle at the left of the search pill and dragging to reposition its order. In the search below, I have taken the Term List search which I had toggled to *OR* and positioned it above the *AND* *"special purpose entity"* keyword search. This changes the result count to 49 documents.

![25 - 08 - Advanced Search Preview reorder-2](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2008%20-%20Advanced%20Search%20Preview%20reorder-2.png?width=1460&amp;quality=high)
  13. Clicking the ***Group All*** indicator collects all search elements into a single Advanced Search pill, much as paired parentheses group sub-clauses. You may click on that pill to re-open and edit items, or delete the entire search construct at once by clicking the **[X]** next to the pill after running the search.

![25 - 14 - Search grouping-3](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2014%20-%20Search%20grouping-3.png?width=916&amp;quality=high)
  14. You may also specify inclusion of Families, Threads, Duplicates or Near Duplicates for any item by clicking the relation indicator for a search pill. ![25 - 14a - Search grouping with families-3](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2014a%20-%20Search%20grouping%20with%20families-3.png?width=1062&amp;quality=high)
9. Click **Search** to retrieve the documents to the screen from which the Advanced Search was called.
10. Extremely long active searches that exceed the size of the Search bar will indicate the existence of additional criteria by fading into the right edge of the bar.

![25 - 15 - Search pills exceed search bar](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2015%20-%20Search%20pills%20exceed%20search%20bar.png?width=1409&amp;quality=high)

## **Reveal 11.8 Update**

### **Improved Drag and Drop**

Drag and drop manipulation of search pills to modify advanced search clauses has been made more intuitive and flexible in the search builder. In the example below (shown in Dark Mode), grabbing the last keyword pill *price* and pulling it up to the keyword pill *power* made it part of a clause *power and price* under the initial terms *enron and agreement*.

![25 - 17 - Drag and Drop Search Pills](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2017%20-%20Drag%20and%20Drop%20Search%20Pills.png?width=1545&amp;quality=high)

Grabbing the term *agreement*in the illustration, we are moving it so that a bar appears under the last term, dropping it into the lower clause to make it *power and price and agreement*. Had we dropped it while the *price* pill was highlighted, it would have made a new clause *price and agreement* under *power*.

![25 - 18 - Search Pill drop result](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2018%20-%20Search%20Pill%20drop%20result.png?width=1299&amp;quality=high)

Clicking on the ellipses (…) following the open parenthesis for the search clause offers the choices to *Ungroup* the pills within the clause or *Delete* the clause.

### **Updated Date Selection**

Selection of dates and date ranges throughout Reveal has been updated. The new selection interface makes it easier to select months or days, and to specify the filtering criterion from among ***Before****,****After****,****Between****,* or ***On***.

![25 - 19 - Updated Date selection](https://5796933.fs1.hubspotusercontent-na1.net/hub/5796933/hubfs/DOCUMENTATION/ARTICLE%20SCREENSHOTS/25%20-%2019%20-%20Updated%20Date%20selection.png?width=609&amp;quality=high)

**Reveal 11.9** has added the Date, Time and DateTime field filter ***Days ago****.*This operator facilitates a search for ‘yesterday’ as ***1****day ago* in the example of a search on *Last Reviewed On Date* over a prior calendar day).

As of **Reveal 2024.3**, date/time search criteria are no longer converted to the user’s locale (time zone).

## Related

- [Create a Term List](/create-a-term-list.md)
- [Search Keywords](/search-keywords.md)
- [Search Guidance – Unicode Rules for Indexing](/search-guidance-unicode-rules-for-indexing.md)
- [Basic Search Augmentations In Reveal](/basic-search-augmentations-in-reveal.md)
- [Search Concepts](/search-concepts.md)