> For the complete documentation index, see [llms.txt](https://docs.datasaur.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.datasaur.ai/advanced/extensions/list-of-files.md).

# List of Files

Displays all project files in an organized list with navigation, search, and status management.

The **List of files** extension shows all files uploaded to a project in an organized, alphabetical list. It helps you get a clear overview of all project files.

In this extension, you can:

* View all files uploaded to the project.
* Navigate between files.
* Filter files by status.
* Update file status (in progress or complete).

{% hint style="info" %}
If the [split files](/data-studio-projects/creating-a-project/split-files.md) feature is used, each file part will also appear in the list.
{% endhint %}

## Enable the extension

Enable this extension from the **Manage Extensions** dialog (gear icon) in the right sidebar.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-392d888c3692d59deaae1e1335b729e825de4fcd%2FExtension%20-%20Manage%20extensions%20-%20List%20of%20files.png?alt=media" alt=""><figcaption></figcaption></figure>

## Labeler mode

In labeler mode, only files assigned to the labeler are shown. Files not assigned to the labeler are hidden to ensure focus on relevant work.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-118375f28d8ce6a0ca444e3c70e11e152129194c%2FExtension%20-%20List%20of%20files%20-%20labeler%20mode%20-%20highlight.png?alt=media" alt=""><figcaption></figcaption></figure>

### File management and navigation

* **Search bar:** Find files by name or ID.
* **Filter:** Filter files by status: In progress or completed.

  <figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-31152e491519b0175f9f9c76aca116e7a67695e3%2FExtension%20-%20List%20of%20files%20-%20labeler%20mode%20-%20filter.png?alt=media" alt=""><figcaption></figcaption></figure>
* **File row:** Click to open the file.
* **File icon**: Shows file status (not started or completed). Status can be updated by clicking the icon.
* **Arrow buttons:** Move to the previous or next file.
* **File number field:** Jump directly to a specific file by entering its order number.

## Reviewer mode

In reviewer mode, **all files** will be displayed in the list.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-968d53ffe1cc586faceca436c2475bf970ce0255%2FExtension%20-%20List%20of%20files%20-%20reviewer%20mode%20-%20highlight.png?alt=media" alt=""><figcaption></figcaption></figure>

### File management and navigation

* **Update now button:** Fetches the latest status of the files.
* **Search bar:** Find files by name or ID.
* **Filter:** Filter files by status: In progress or completed.

  <figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-05a97bde27d0e4a26534e119bd9a076df737f0bc%2FExtension%20-%20List%20of%20files%20-%20reviewer%20mode%20-%20more%20menu.png?alt=media" alt=""><figcaption></figcaption></figure>
* **File row:** Click to open the file.
* **File icon**: Shows file status (not started or completed). Status can be updated by clicking the icon.
* **Labeler indicator:** Shows completion status per labeler.
  * Statuses
    * Completed by all labelers
    * Completed by some labelers
    * Not started by any labeler
  * Hover to see which labelers have not completed the file.
  * A blue triangle indicates that the reviewer is also a labeler for the file.

    <figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-58ab1430c4e037d9e4f21c3a0c0b58641c609ca1%2FExtension%20-%20List%20of%20files%20-%20reviewer%20mode%20-%20labelers%20progress.png?alt=media" alt=""><figcaption></figcaption></figure>
* **Arrow buttons:** Move to the previous or next file.
* **File number field:** Jump directly to a specific file by entering its order number.

### In-review document indicator

Managing review status helps ensure documents are reviewed by one person at a time, reducing duplication and improving workflow.

{% hint style="info" %}
Starting from version 6.94, the in-review document indicator is available for team workspaces and is disabled by default. To enable it, contact support [**support@datasaur.ai**](mailto:support@datasaur.ai)**.**
{% endhint %}

#### How it works

When enabled, the reviewer’s name appears under the document name, showing who is currently reviewing it or updating its status. Documents can have three statuses:

* **Not started**: Review has not begun.
* **In review**: The document is currently being reviewed.
* **Complete**: The review is finished.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-3a26f8998b3c3bad668541c8f4a48aa59fbf151d%2FExtension%20-%20List%20of%20files%20-%20reviewer%20mode%20-%20mark%20document%20status.png?alt=media" alt=""><figcaption></figcaption></figure>

If a member not assigned as a reviewer tries to change a document’s status, they must first assign themselves as a reviewer. A dialog will appear to confirm this action.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-b9eadf6a6fe28c962f30287a6b05fb356026776d%2FExtension%20-%20List%20of%20files%20-%20reviewer%20mode%20-%20assign%20yourself.png?alt=media" alt=""><figcaption></figcaption></figure>

#### Review status permissions

When a document has **In review** status and there are multiple reviewers, changing a document’s status follows these permissions:

| **Current status**     | **New status**            | **Can it be changed?**  |
| ---------------------- | ------------------------- | ----------------------- |
| Not Started            | In Review (same reviewer) | ✅                       |
| Not Started            | Complete (same reviewer)  | ✅                       |
| In Review (Reviewer A) | Not Started (Reviewer A)  | ✅                       |
| In Review (Reviewer A) | Not Started (Reviewer B)  | ⚠ Confirmation required |
| In Review (Reviewer A) | Complete (Reviewer A)     | ✅                       |
| In Review (Reviewer A) | Complete (Reviewer B)     | ⚠ Confirmation required |
| In Review (Reviewer A) | In Review (Reviewer B)    | ⚠ Confirmation required |
| Complete (Reviewer A)  | Not Started (Reviewer A)  | ✅                       |
| Complete (Reviewer A)  | In Review (Reviewer A)    | ✅                       |
| Complete (Reviewer A)  | Not Started (Reviewer B)  | ❌                       |
| Complete (Reviewer A)  | In Review (Reviewer B)    | ❌                       |
| Complete (Reviewer A)  | Complete (Reviewer B)     | ❌                       |

#### Filter by document status and its reviewer

Reviewers can filter documents by:

* Status (not started, in review, complete)
* Assigned reviewer

This helps teams quickly find:

* Documents not yet reviewed.
* Documents currently under review.
* Completed documents.
* Who is responsible for each review.

The filter improves navigation and helps track review progress more efficiently.

<figure><img src="https://448889121-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MbjY0HseEqu7LtYAt4d%2Fuploads%2Fgit-blob-766f15527bf59999c46fd4f8ffc4878d4f47d925%2FExtension%20-%20List%20of%20files%20-%20reviewer%20mode%20-%20filter.png?alt=media" alt=""><figcaption></figcaption></figure>