# Filter documents

## Filters

Open '**Filters**' on the left of the search bar:

<figure><img src="/files/7sXc4fA7JAc1BonNClV7" alt="Screenshot of Datashare&#x27;s page to search documents with the &#x27;Filters&#x27; button at the left of the search bar highlighted"><figcaption></figcaption></figure>

<figure><img src="/files/g6wQcWdovhBjdaUhFrRw" alt="Screenshot of Datashare&#x27;s page to search documents with the &#x27;Filters&#x27; panel open and highlighted on the left of the page and on the right of the menud"><figcaption></figcaption></figure>

**'Indexing dates'** arethe dates when the documents were added to Datashare.

**'Embedment levels'** regard embedded documents:

* The 'file on disk' is level zero
* If a document is attached to (or contained in) a file on disk, its embedment level is '1st'
* If a document is attached to (or contained in) a document itself contained in a file on disk, its embedment level is '2nd'
* And so on

## Filter by entities

If you asked Datashare to '**Find entities**' and the task was complete, you will see names of people, organizations, locations and e-mail adresses in the filters. These are the entities **automatically detected by Datashare:**

<figure><img src="/files/I6BvaixvN1eGS57ZQYeQ" alt="Screenshot of the Filters&#x27; entities" width="335"><figcaption></figcaption></figure>

## Exclude filters

Tick the '**Exclude**' checkbox to select all items except those selected.

In the search breadcrumb, you see that the excluded filters are **strikethrough**:

<figure><img src="/files/hTKvsAXgMu8Oq3xAmgQT" alt="Screenshot of Datashare&#x27;s page to search documents with the &#x27;People&#x27; filter open with 2 names ticked and the Exclude button ticked and highlighted as well as the two names in the search breadcrumb that are also strikethrough"><figcaption></figcaption></figure>

## Contextualize filters

In most filters, tick '**Contextualize'** to **update the number of documents indicated in the filters so they reflect the results**.

The filter will only count what you selected, it will reflect the results of your current selection:

<figure><img src="/files/7JXsFpesu0BGHThfVNHK" alt="Screenshot of Datashare&#x27;s page to search documents with a filter open and the Contextualize button at the bottom of this filter highlighted"><figcaption></figcaption></figure>

<figure><img src="/files/d2ZxDFkRdIjn5kAPVSsI" alt="Screenshot of Datashare&#x27;s page to search documents with the &#x27;Language&#x27; filter open, the &#x27;Contextualize&#x27; checkbox ticked and the whole filter highlighted"><figcaption></figcaption></figure>

## Clear all filters

To reset all filters at the same time, open the **search breadcrumb**:

<figure><img src="/files/BOnlJodlrHVAKMOJyJI7" alt="Screenshot of Datashare&#x27;s page to search documents with the &#x27;Your search&#x27; button on the left of the search bar highlighted"><figcaption></figcaption></figure>

Click '**Clear filters**':

<figure><img src="/files/Of3Uym7vONN8GSI8BnFA" alt="Screenshot of Datashare&#x27;s page to search documents with search breadcrumb open and the &#x27;Clear filter&#x27; button highlighted"><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://icij.gitbook.io/datashare/usage/filter-documents.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
