# Star, tag and recommend

## Star documents

{% hint style="info" %}
In server collaborative mode, starring documents is **private**. Other members of your projects can't see your starred documents.
{% endhint %}

#### Star a single document

Click the **star icon** either at the right of the document's card or at the top right of the document:

<figure><img src="/files/6BIIDEz1vY1zmeynTf2n" alt="Screenshot of Datashare&#x27;s search documents page in List layout with a document open and its star icon on the top right is highlighted"><figcaption></figcaption></figure>

Click on the same icons to unstar.

#### Star multiple documents

Open the **selection mode** by clicking the **multiple cards icon** on the left of the pagination:

<figure><img src="/files/Fqjx6j8ooexlvnRcjk0H" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the selection mode button on the left of the results&#x27; paginationis highlighted"><figcaption></figcaption></figure>

**Select the documents** you want to star:

<figure><img src="/files/5fU8AlJYiNIjn34H6Pma" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the selection mode is open and 3 documents are ticked and their checkboxes are highlighted"><figcaption></figcaption></figure>

Click the **star filled icon**:

<figure><img src="/files/xzdrrW2HbofV0QmZnfYb" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the selection mode is open and 3 documents are ticked the star filled icon is highlighted"><figcaption></figcaption></figure>

To unstar documents, click the three-dot icon if necessary and click **Unstar**:

<figure><img src="/files/LyGRD7EXz0C64Spqb4ap" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the selection mode is open and 2 documents are ticked, the &#x27;Unstar&#x27; entry in the three-dot dropdown is highlighted"><figcaption></figcaption></figure>

<figure><img src="/files/0jW7kGo17c5PqP6XNRoO" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the selection mode is open and 3 documents are ticked, the &#x27;Unstar&#x27; button is highlighted"><figcaption></figcaption></figure>

#### Filter starred documents

Open the filters by clicking the '**Filters**' button on the left of the search bar:

<figure><img src="/files/A1eWiJgrp8VO7k7P2ouR" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the &#x27;Filter&#x27; button on the left of the search bar is highlighted"><figcaption></figcaption></figure>

In the '**User data**' category, open '**Starred**' and tick the '**Starred**' checkbox:

<figure><img src="/files/oHl2mh4nPRbXDixw6mAP" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the &#x27;Filters&#x27; are open on the left and the &#x27;Starred&#x27; filter is open and highlighted"><figcaption></figcaption></figure>

## Tag documents

{% hint style="info" %}
Tags are always in lower case letters. They can contain numbers, hyphens and special characters but not commas nor semicolons (which are the keyboard shortcuts to add the tags).
{% endhint %}

{% hint style="info" %}
In server collaborative mode, tags are **public** to the project's other members. You can see their tag and they can see yours.
{% endhint %}

#### Tag a single document

Open a document in '**Search**' > '**Documents**' > open on a document and above the document's name, click on the **hashtag icon**:

<figure><img src="/files/lkKn6lZ7r5xChEp1Y8lU" alt="Screenshot of Datashare&#x27;s search documents page in List layout where a document is open and its &#x27;Hashtag&#x27; (tag) button above its title is highlighted"><figcaption></figcaption></figure>

It opens the **Tags panel** on the left:

<figure><img src="/files/VvBmzTaUL3QzGIgFbbcm" alt="Screenshot of Datashare&#x27;s search documents page in List layout where a document is open and the &#x27;Tags&#x27; floating panel on the left of the document is highlighted"><figcaption></figcaption></figure>

**Type your tag** and press **Enter** or click '**Add**':

<figure><img src="/files/D2CDF9oJJPHOfrZvZTRv" alt="Screenshot of Datashare&#x27;s search documents page in List layout where a document is open, the &#x27;Tags&#x27; floating panel on the left of the document is open and the field to add filters is highlighted"><figcaption></figcaption></figure>

Your tag is now displayed in the 'Added by you' category:

<figure><img src="/files/xAUw9ClaRVkGf77NK0aq" alt="Screenshot of Datashare&#x27;s search documents page in List layout where a document is open, the &#x27;Tags&#x27; floating panel on the left of the document is open and the category &#x27;Added by you&#x27; is highlighted"><figcaption></figcaption></figure>

**Remove** your tag, or others' tags, by clicking their **cross** **icon**:

<figure><img src="/files/iDB0EQY1V8vpTRtJWuQ8" alt="Screenshot of Datashare&#x27;s search documents page in List layout where a document is open, the &#x27;Tags&#x27; floating panel on the left of the document is open and the Cross icons in 2 tags label are highlighted"><figcaption></figcaption></figure>

#### Tag multiple documents

Open the **selection mode** by clicking the **multiple cards icon** on the left of the pagination:

<figure><img src="/files/Fqjx6j8ooexlvnRcjk0H" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the selection mode button on the left of the results&#x27; paginationis highlighted"><figcaption></figcaption></figure>

**Select the documents** you want to tag:

<figure><img src="/files/5fU8AlJYiNIjn34H6Pma" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the selection mode is open and 3 documents are ticked and their checkboxes are highlighted"><figcaption></figcaption></figure>

Click the three-dot icon if necessary and click '**Tag**':

<figure><img src="/files/zMP6aXvaH0A5IADotXLv" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the selection mode is open and 2 documents are ticked, the &#x27;Tag&#x27; entry in the three-dot dropdown is highlighted"><figcaption></figcaption></figure>

<figure><img src="/files/FOkfo3IjyRuU85QwdNPY" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the selection mode is open and 3 documents are ticked, the &#x27;Tag&#x27; button is highlighted"><figcaption></figcaption></figure>

Type your tag or type multiple tags by separating them with comma and click '**Add**':

<figure><img src="/files/RjEf5TrEAawVFebSaHxd" alt="Screenshot of Datashare&#x27;s search documents page in List layout where a modal to add Tags is open"><figcaption></figcaption></figure>

**Remove** your tag, or others' tags, by clicking their **cross** **icon on each single document** (you cannot untag multiple documents):

<figure><img src="/files/iDB0EQY1V8vpTRtJWuQ8" alt="Screenshot of Datashare&#x27;s search documents page in List layout where a document is open, the &#x27;Tags&#x27; floating panel on the left of the document is open and the Cross icons in 2 tags label are highlighted"><figcaption></figcaption></figure>

#### Filter tagged documents

Open the filters by clicking the '**Filters**' button on the left of the search bar:

<figure><img src="/files/A1eWiJgrp8VO7k7P2ouR" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the &#x27;Filter&#x27; button on the left of the search bar is highlighted"><figcaption></figcaption></figure>

In the '**User data**' category, open '**Tags**' and tick the '**Tag**' checkboxes for tagged documents you want to filter:

<figure><img src="/files/KZeGbS03tnsJdnoIv8TV" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the &#x27;Filters&#x27; are open on the left and the &#x27;Tags&#x27; filter is open and highlighted"><figcaption></figcaption></figure>

## Recommend a document

{% hint style="info" %}
In server collaborative mode, recommending documents is **public** to the project's other members. All members can see who recommended some documents.
{% endhint %}

Open a document in '**Search**' > '**Documents**' > open on a document and above the document's name, click on the **eyes icon**:

<figure><img src="/files/sIhyBWLPCD5lh28pbBGs" alt="Screenshot of Datashare&#x27;s search documents page in List layout where a document is open and its &#x27;Eyes&#x27; (recommend) button above its title is highlighted"><figcaption></figcaption></figure>

It opens the **Recommendations panel** on the left:

<figure><img src="/files/3a3G2asbQgmriPOZckAN" alt="Screenshot of Datashare&#x27;s search documents page in List layout where a document is open and the &#x27;Recommendations&#x27; floating panel on the left of the document is highlighted"><figcaption></figcaption></figure>

Click on the **'Mark as recommended'** button:

<figure><img src="/files/6rHiKflw40tL08taVbPH" alt="Screenshot of Datashare&#x27;s search documents page in List layout where a document is open and the &#x27;Recommendations&#x27; floating panel on the left of the document is open and the button &#x27;Mark as recommended&#x27; is highlighted"><figcaption></figcaption></figure>

The document is now marked as recommended by you:

<figure><img src="/files/Yv32t3IgbSOfrdnP1ZQc" alt="Screenshot of Datashare&#x27;s search documents page in List layout where a document is open and the &#x27;Recommendations&#x27; floating panel on the left of the document is open and where the username (you) is highlighted"><figcaption></figcaption></figure>

Click 'Unmark as recommended' to unmarked it as recommended.

#### Filter recommended documents

Open the filters by clicking the '**Filters**' button on the left of the search bar:

<figure><img src="/files/A1eWiJgrp8VO7k7P2ouR" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the &#x27;Filter&#x27; button on the left of the search bar is highlighted"><figcaption></figcaption></figure>

In the '**User data**' category, open '**Recommended by**' and tick the '**Username**' checkboxes for documents recommended by the users you want to filter:

<figure><img src="/files/iDEFdYCujz7HMCcdeiGY" alt="Screenshot of Datashare&#x27;s search documents page in List layout where the &#x27;Filters&#x27; are open on the left and the &#x27;Recommended by&#x27; filter is open and 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/star-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.
