> For the complete documentation index, see [llms.txt](https://docs.biobox.io/guide/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.biobox.io/guide/how-to/create-multi-modal-dashboards.md).

# Create Multi-Modal Dashboards

Creating multi-modal dashboards with data from your graph.

Dashboards let you assemble multimodal data to tell a biological story. Each dashboard is composed of a set of widgets. A widget runs a query against your graph and displays the data in a table, scatter plot, or box plot.

### Create a Dashboard

There are two ways to create a dashboard:

1. **From a template.** Pick a pre-built template and the dashboard builds itself. This is the fastest option and works well for repeatable workflows like target profiling.
2. **From a blank dashboard.** Start with an empty page and describe the data you want to see in plain language. BioBox writes the query and configures the widget for you.

To access Dashboards, select **“Dashboards”** from the application toolbar.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FgNN25Hh1eJcUVbSOdrLT%2FDashboard%20navigation4k.mp4?alt=media&token=1b4b87b1-d13d-455c-8ca1-a240b88728f4>" %}

#### Create a dashboard from a template

Templates are prebuilt dashboards that your team has set up for a specific type of analysis. The widgets, queries, and layout are already defined. All you need to do is tell the template which object to focus on.

1. Select **“New Dashboard”** in the top right corner.
2. Give your dashboard a name and description.&#x20;
3. Under **Choose Template**, select the template you want to use. The Data Filters panel on the right will update to show the inputs the template needs.&#x20;
4. Fill in each filter. Required filters must be set before you can continue. Optional filters can be left blank, in which case the widgets that depend on them will show all results. This is predefined by the dashboard template.&#x20;
5. Select **“Create Dashboard”**.

For example, select a "Target Profiling" template where the required filter is a gene symbol. This template would filter all of the widgets programmed to display data for your gene of interest.&#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FIXc0aAsMYOrZtZU3j3m2%2FDashboardfromTemplate.mp4?alt=media&token=065b7223-4126-4e8b-b6c5-86c8f718f0f8>" %}

The dashboard will be prepopulated with all of the widgets programmed in the template and any filters you have applied.&#x20;

#### Create a dashboard without a template

If none of the templates fit your needs, or you just want to pull together a few specific data points, you can start from a blank dashboard and build each widget by describing it.

1. Select **“New Dashboard”**.
2. Give your dashboard a name and an optional description.
3. Under **Choose Template**, select **“Start from blank”**.
4. Select **“Create Dashboard”**. You will be taken to an empty dashboard.

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2F3E1MIs1eTBRy4wscoSlj%2FBlack%20Dashboard.mp4?alt=media&token=2f7913c3-665e-44b0-a97a-a56585a9fcec>" %}

#### **Adding widgets to your dashboard**&#x20;

1. Select **“Add Widget”** in the top right corner of the dashboard.
2. Choose the type of widget you want to add:
   * **Data Table** for tabular results
   * **Box Plot** for distribution analysis
   * **Scatter Plot** for X-Y correlation

<figure><img src="https://1288106818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FH8yntBm4usWo3CQqIEqF%2FScreenshot%202026-10-15%20at%205.42.12%E2%80%AFPM.png?alt=media&amp;token=621c4b53-fd7c-4e5d-9af1-98f9fbd5efd5" alt=""><figcaption></figcaption></figure>

An empty widget will be added to the bottom of your dashboard. At the top of the widget, you can choose how you want to define the data: **Natural Language** or **Query Language**.<br>

<figure><img src="https://1288106818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FOZvbWL76gYSH3Vu53eQa%2FScreenshot%202026-10-15%20at%205.43.32%E2%80%AFPM.png?alt=media&amp;token=ef43d060-13b6-41cb-bfa9-4027d594a72b" alt=""><figcaption></figcaption></figure>

#### **Describe your data using natural language**

1. With **Natural Language** selected type a description of the data you would like to see. Keep it short and specific. Name the objects you care about and any conditions. For example:

* “Phase 1 psoriasis clinical trials”
* “Single cell datasets where MTOR is differentially expressed with an adjusted p-value below 0.05”
* “Cell lines with a dependency on NECTIN4”

2. Select **“Generate Query”**.

BioBox will interpret your description and transform it into a graph query. Here you will see:

* **Your description**, exactly as you typed it
* **Generated Query**, the query language BioBox produced from your description. This is editable, so you can tweak it directly if you want to adjust a filter or add a condition.
* **How this was determined**, which you can expand with **“Show details”** to see how BioBox mapped your words onto concepts and relationships in your graph

4. Select **“Apply Query”**.

The widget will run the query and populate the widget with data.&#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2Fs4TJEwwgSHBZ7FbluPGk%2FNL%20TO%20QL%20Dashboards.mp4?alt=media&token=0b24c72f-ec4b-4b71-a30c-13b7545caf6f>" %}

### **Filtering Dashboard Data**

#### **Quickly add filters by display name**&#x20;

To quickly apply filters, use the filter bar located above your widgets. Select a biological concept you would like to filter e.g. disease, gene, pathway etc and type in the name of the object. This will filter all widgets in your dashboard that use the biological concept. <br>

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FunwdScyqdfWxinJGvJ5Q%2FQuick%20Filters%20Dashboard.mp4?alt=media&token=be56dab2-5518-4c5a-847b-ba03f4b1b4be>" %}

#### **Advanced filters**&#x20;

To apply filters on additional data properties, select "Advanced Filters".  This will allow you to apply comprehensive filters to any data property associated with a biological concept. For example, clinical trial phase, differential expression p value and much more. This will filter all widgets in your dashboard that use the biological concept.&#x20;

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2F6cfzqiXkr4lVMMaBvNzU%2FAdvanced%20Filters%20Dashboardlow.mp4?alt=media&token=b47967f1-6a30-4561-bb10-f7d07acdf8fc>" %}

#### **Reorder Widgets**

The reorder button will open a dialogue that will enable you to change the order of the widgets in your dashboard.&#x20;

#### **Edit, expand, or remove a widget**

Each widget has three icons in its top right corner:

* **Expand** opens the widget in full screen
* **Edit** reopens the Describe Your Data window so you can change the description or query
* **Delete** removes the widget from the dashboard

{% embed url="<https://files.gitbook.com/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F58V5gIKqqiaGKIL0OodX%2Fuploads%2FoiE1z332UkODs8Zq2Rkg%2Freorder%20and%20edit%20widgets.mp4?alt=media&token=47c2650a-8003-401f-a8bf-7eb892ee87a6>" %}

Reordering, editing, expanding, and removing a widget are only applicable to dashboards created without a template. Dashboards created with a template will reflect the size and order saved in the template.&#x20;
