> For the complete documentation index, see [llms.txt](https://docs.docbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docbits.com/end-user-and-partner-section/end-user-section/dashboard.md).

# Dashboard

Find, review and organize documents in the current DocBits dashboard.

The dashboard is your daily worklist in DocBits. Find imported documents, check their status, open them for validation and organize the work with your team.

{% hint style="info" %}
The controls you see depend on your permissions, the document status and the modules enabled for your organization. Some controls described here may be unavailable. On narrower desktop windows, additional toolbar actions appear under **More**.
{% endhint %}

<figure><img src="https://578966019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2n2w4uDCJvv7CJ5zrdk%2Fuploads%2Fgit-blob-6d1bd191472be937f8347c8e2b9cfc4e9c35d980%2Fdashboard-overview.png?alt=media" alt="The current dashboard: search and tools at the top, saved views and document types below, and the document table. Document values are hidden for privacy."><figcaption><p>The current dashboard: search and tools at the top, saved views and document types below, and the document table. Document values are hidden for privacy.</p></figcaption></figure>

## Search in everyday work — video

This short example starts at the desk of a customer in Austin, Texas. The US English DocBits interface then fills the screen: type part of a file name, press Enter, and check the result. The second example shows how to include document content when the full-text search module is enabled.

{% embed url="<https://docbits-videos.fra1.cdn.digitaloceanspaces.com/settings-assistant/dashboard-search-customer/v1/en.mp4>" %}

[Open the example with US English narration](https://docbits-videos.fra1.cdn.digitaloceanspaces.com/settings-assistant/dashboard-search-customer/v1/en.mp4) · [English captions (VTT)](https://docbits-videos.fra1.cdn.digitaloceanspaces.com/settings-assistant/dashboard-search-customer/v1/en.vtt) · [English transcript](https://docbits-videos.fra1.cdn.digitaloceanspaces.com/settings-assistant/dashboard-search-customer/v1/en.txt)

## Dashboard tools — English walkthrough

The same customer from Austin shows how she works with the dashboard: find a test invoice, apply and clear a status filter, open the search help, inspect the column settings, check the status overview and refresh the worklist. The walkthrough uses the current US English interface. Available controls depend on your permissions and enabled modules.

{% embed url="<https://docbits-videos.fra1.cdn.digitaloceanspaces.com/settings-assistant/dashboard-tour-customer/v2/en.mp4>" %}

[Open the player with English subtitles](https://docbits-videos.fra1.cdn.digitaloceanspaces.com/settings-assistant/dashboard-tour-customer/v2/en.html) · [Open the MP4](https://docbits-videos.fra1.cdn.digitaloceanspaces.com/settings-assistant/dashboard-tour-customer/v2/en.mp4) · [English captions (VTT)](https://docbits-videos.fra1.cdn.digitaloceanspaces.com/settings-assistant/dashboard-tour-customer/v2/en.vtt) · [English transcript](https://docbits-videos.fra1.cdn.digitaloceanspaces.com/settings-assistant/dashboard-tour-customer/v2/en.txt)

Use full-screen playback to read the interface on smaller screens.

The sample selection stays active throughout the walkthrough. The column settings are inspected and closed without saving changes.

## Start your daily work

1. Check the active organization and, if available, the suborganization.
2. Select a document type or leave **All** selected.
3. Use the search and filters to find your documents.
4. Check **Status** and **Assigned To**, then open the document row to review it.
5. Refresh the list after processing or importing documents.

## Search and filter documents

Enter a document name, invoice number or other business value in the search box and press **Enter**. Use the filter icon inside the search box for **Status**, **Assigned To** and **Restart required**, then choose **Apply**. Remove individual filter badges or use **Clear filters** when a document seems to be missing. Document-type tabs and saved views also narrow the list.

The search toolbar also provides structured search chips, a raw query view and a **Fields & Syntax** help dialog. Copy field names and examples from that dialog; keep technical field names unchanged when changing the UI language. Advanced search features depend on the search capabilities enabled for your organization.

With full-text search enabled, the content-search menu controls a plain-text search: **Automatic** searches business fields first and uses document content when those fields have no matches; **Include document content** includes content matches; **Fields only** restricts the search to fields. A content-result badge explains when results came from document content. A `+` after a result count indicates a limited result window; narrow the search for a more precise result set.

When the separate date-range control is shown, choose a preset or a custom import-date range. It is hidden when fulltext search is enabled; use the available date fields in the search bar instead.

<figure><img src="https://578966019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2n2w4uDCJvv7CJ5zrdk%2Fuploads%2Fgit-blob-d0cc0e0e8fd7ead7151de4f39717423afe72fabc%2Fdashboard-filters.png?alt=media" alt="Filter by status, assignee and whether a restart is required."><figcaption><p>Filter by status, assignee and whether a restart is required.</p></figcaption></figure>

## Read and arrange the document table

Each row represents a document. Depending on your column configuration, it shows its name, status, document type, invoice data, supplier, assignee, dates and amounts. Click a sortable column header to change the order. Scroll horizontally to see more columns and use the page controls and **Documents per Page** at the bottom to move through the results.

If grouping is available, select a grouping field above the table. For date fields, choose day, week or month. Open a group to see its documents, or remove the grouping to return to the flat list.

Use the **+** next to the document-type tabs to show additional tabs. The tabs can be reordered by dragging. Removing a tab changes your view; it does not delete documents.

Open the gear icon and the column-settings button to choose visible columns, move columns between the hidden and visible lists, and drag visible columns into order. You can also add fields from a document type. See [Change document columns](https://docs.docbits.com/end-user-and-partner-section/end-user-section/dashboard/change-document-columns.md).

<figure><img src="https://578966019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2n2w4uDCJvv7CJ5zrdk%2Fuploads%2Fgit-blob-010af5da794f679d52970125ee2a8df6221f01a7%2Fdashboard-columns.png?alt=media" alt="Column settings let you choose and order the information shown in the table."><figcaption><p>Column settings let you choose and order the information shown in the table.</p></figcaption></figure>

## Understand status and document actions

Processing statuses show steps such as OCR, classification or export. **Ready for validation** means the document is ready for review; approval statuses indicate that an approval step is pending. **Exported** means the document’s export has completed. For **Error**, click the error status to inspect the available error details.

If processing times are available, hover over a status to see the phases and their durations. A duplicate icon appears for documents with possible duplicates; open it to compare the related documents.

Open a document row to work in the validation screen. Use the row's **Actions** menu for the operations allowed for that document, such as assignment, download, history or restarting processing. Available download variants depend on the document and can include annotations or electronic invoice formats.

Select the checkboxes for several documents and open the menu in the table header for permitted bulk actions, such as assignment, merging, restart, restart export or deletion. Check the selection and confirmation carefully. These actions can change documents; saving a view only changes how the worklist is displayed.

## Document Logs

Open the row's **Actions** menu and choose **Document Logs** to see what happened to a document.

The popup lists the recorded entries in four columns: **Modified By/On**, **Description**, **Previous Status** and **Current Status**. If nothing was recorded for the document, it shows **No Record Found!**.

Widen or narrow a column by dragging the divider between two column headers. When the popup is narrower than the table, scroll sideways to reach the last column; the header stays visible while you scroll through the rows. A description that is cut off in its cell shows the full text when you hover over it.

Close the popup with the X in its title bar.

## Save a personal dashboard

Open the blue view badge below the search box and choose **Create New Dashboard**. Give the view a name and choose whether it is private, visible to all users or shared with selected groups and users. Save the filters, sort order and columns you need for recurring work.

Select a saved view from the same menu. Save later changes with **Save Dashboard Changes** when the view is yours and has changed. A view shared with you cannot be overwritten by you; create your own view instead. Sharing a view does not grant additional access to documents. See [Personal dashboards](https://docs.docbits.com/end-user-and-partner-section/end-user-section/dashboard/personal-dashboards.md).

<figure><img src="https://578966019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2n2w4uDCJvv7CJ5zrdk%2Fuploads%2Fgit-blob-105d4ac6a7cecf619b49e2fb8aea29648b8b645d%2Fdashboard-saved-view.png?alt=media" alt="Create a named dashboard and choose who can see it."><figcaption><p>Create a named dashboard and choose who can see it.</p></figcaption></figure>

## Upload documents and use the toolbar

Choose **Upload**, drop files into the dialog or select them from your computer, then start the upload. If available, use **Classify As** to choose the document type explicitly. Otherwise, DocBits classifies the imported files automatically.

The other toolbar buttons refresh the list, open advanced settings, start a scanner, show status statistics, start the configured email import or request a CSV/Excel table export. Scan and export require the relevant configuration. Table export is separate from exporting a document to your ERP. For a saved dashboard, save column changes before requesting an export because the export uses the saved column configuration. See [Dashboard tools](https://docs.docbits.com/end-user-and-partner-section/end-user-section/dashboard/dashboard-tools.md).

<figure><img src="https://578966019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2n2w4uDCJvv7CJ5zrdk%2Fuploads%2Fgit-blob-637924c7efd08312872eb230bbf45a1a16e19bee%2Fdashboard-upload.png?alt=media" alt="Upload files and optionally choose their document type before importing."><figcaption><p>Upload files and optionally choose their document type before importing.</p></figcaption></figure>

## If a document or control is missing

Check the organization, active view, document type, search text and filter badges first. Refresh the list and check further result pages. If a control is still unavailable, ask your administrator to check your permissions and enabled modules.

**Ctrl/Cmd + K** opens the global quick search. **Ctrl/Cmd + Q** refreshes the dashboard and **Ctrl/Cmd + H** opens help. The gear menu contains the keyboard-shortcut reference. An organization-wide pending-document counter, when shown, is an administrator indicator; it is not your personal task count.

Use Ctrl on Windows/Linux and Cmd on macOS for the shortcuts below. Browser or operating-system shortcuts may take priority.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

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

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://docs.docbits.com/end-user-and-partner-section/end-user-section/dashboard.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
