> For the complete documentation index, see [llms.txt](https://docs.corraldata.com/kb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.corraldata.com/kb/explore-your-data/data-apps.md).

# Data Apps

## Data Apps

Data apps are custom board tiles. Use them when you need a layout or interaction that goes beyond CorralData's standard widgets: an interactive table, a multi-panel view, a custom gauge, or any bespoke visualization specific to how your team works. You don't need to know any code – just describe what you want.

***

### Creating a Data App

**The easiest way is to ask AskCorral.** Describe what you want in plain language, including the data you want to see, the layout, and any filters, then AskCorral builds it for you.

You can also create a data app with Claude or ChatGPT if you have [CorralData MCP connected](https://docs.corraldata.com/kb/mcp/overview). Same idea: describe what you want and it builds it there instead.

**Here's how it works:**

{% stepper %}
{% step %}

#### **Describe it**

Say what you want in plain language: the data, the layout, and any filters. For example, "a prep sheet for today's appointments, with each client's service, upsell opportunity, and rebooking window." That's enough to start.
{% endstep %}

{% step %}

#### **Preview it**

AskCorral builds it and shows you a live preview. Ask for changes in plain language until it's right.

{% hint style="info" %}
If a preview doesn't show up right away, just tell AskCorral to try again.
{% endhint %}
{% endstep %}

{% step %}

#### **Add it to your board**

Once it looks good, say so, and AskCorral can add it to a new board or an existing one.

{% hint style="info" %}
You'll need edit access on the board to save it. If you're not sure what access you have, check with your CorralData admin or see [Add & manage users](https://docs.corraldata.com/kb/getting-started/manage-users).
{% endhint %}
{% endstep %}

{% step %}

#### **Use it**

It's live from then on: open it like any other board, and the data updates every time you load it.

{% hint style="info" %}
From here, moving, resizing, or removing it works the same as any other widget. See [Manage Widgets](https://docs.corraldata.com/kb/organize-your-data/manage-widgets) if you need a refresher.
{% endhint %}
{% endstep %}
{% endstepper %}

***

### Switch to a Full-Page Data App

<figure><img src="https://3884465703-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FX1EfMFQH2czMeSc77MEN%2Fuploads%2FfM8CbsPVTbNTps7LVYGM%2FScreenshot%202026-09-21%20at%203.17.35%E2%80%AFPM.png?alt=media&amp;token=88b0c19c-75de-45d1-b294-3c5ad71ee223" alt="Full Width Data App"><figcaption></figcaption></figure>

By default, a board with a Data App shows it as a tile alongside your other widgets, same as any other board. **If a board has exactly one Data App, you can switch it to a full-page view instead** – no widget tile, just the app with the whole screen to work with. Good for wide tables, dense dashboards, or anything easier to read with more room.

**To switch to full-page:**

1. You must be an **Editor** or **Admin to** make the switch
2. Find the board in the left nav
3. Click the board menu (···)
4. Choose **Switch to App.** Your Data App will convert to full-page and the board's name in the nav now carries an **App** badge.

**To switch back to Classic:**

1. Open the same board menu
2. Choose **Switch to Board**

{% hint style="info" %}
**Full-page view only works for boards with a single Data App.** If a board has more than one, keep it on Classic — full-page will only show the first one and hide the rest.
{% endhint %}

### What can you build as a Data App?

Data apps give you full control and are endlessly customizable. They don't even have to be about numbers at all: a schedule, a service menu, a staff roster, a set of instructions can all become a data app. Here are a few use cases:

* **Interactive tables:** Sortable, filterable views of your data that go beyond a static report.\
  *<mark style="color:$primary;">**Try:**</mark>* *<mark style="color:$primary;">"Build me a data app with a table of today's schedule gaps next to anyone overdue for a follow-up, so I can fill open slots before end of day."</mark>*<br>
* **Multi-panel views:** Several related views combined into a single tile.\
  *<mark style="color:$primary;">**Try:**</mark>* *<mark style="color:$primary;">"Build me a data app where I can monitor revenue, appointment volume, and staffing by location, with each location as its own tab in the view"</mark>*<br>
* **Custom gauges and scorecards:** A purpose-built visual for metrics your team watches most closely.\
  *<mark style="color:$primary;">**Try:**</mark>* *<mark style="color:$primary;">"Build me a data app with a gauge showing this month's average appointment lead time against our 3-day target."</mark>*<br>
* **Bespoke visualizations:** Anything a standard chart type can't do, built to match how you actually think about the data.\
  *<mark style="color:$primary;">**Try:**</mark>* *<mark style="color:$primary;">"Build me a data app with a view of all my locations, color-coded by health status and grouped by region, so I can see who needs attention at a glance."</mark>*<br>
* **Interactive modeling tools:** Sliders and scenario toggles that let your team change assumptions and watch the outcome update, live, not just view a static number.\
  *<mark style="color:$primary;">**Try:**</mark>* *<mark style="color:$primary;">"Build me a data app of a what-if revenue simulator with sliders for members per site and monthly churn, showing where the projected uplift comes from."</mark>*<br>
* **Reference tools, not tied to a number:** A table or list built from your data, with no metric involved.\
  *<mark style="color:$primary;">**Try:**</mark>* *<mark style="color:$primary;">"Build me a data app of a lookup table of our current service menu, with pricing and duration, grouped by category."</mark>*

{% hint style="info" %}
Data Apps are now AskCorral's **default** for open-ended build requests — ask for a dashboard or report without naming a chart type and you'll get a Data App. If you ask for a specific widget type ("give me a bar chart"), AskCorral honors that instead; say **"build me a data app"** when you want to make sure you get one.
{% endhint %}

***

### Data Apps stay in sync with your board

Just like native widgets, data apps respond automatically to your board's filters and date range. Pick a location, a date window, or another filter at the top of the board, and any data app on it updates right along with everything else. You don't need to set this up: describe the filter behavior you want when you ask AskCorral to build it, and it handles the rest.

A data app also stays live and org-wide once it's built. It queries your data on every load, so it's never a stale snapshot, and it lives on your board, visible to everyone whose permissions allow it, not buried in a chat history.

{% hint style="success" %}
**Tips for best results**

* **Describe the outcome, not the mechanics.** Say what you want to see and why (for example, "a table of my top 10 locations by revenue this month, filterable by service line") and let AskCorral figure out the rest.
* **Mention filters up front.** If you want the data app to respond to a board filter, such as location, date range, or provider, say so in your first request.
* **Reference an example.** If you've seen a layout you like, on another board or in a screenshot, describe it or point to it. AskCorral can match an existing style.
* **Got a regular widget instead of a data app?** Say "make this a data app" and AskCorral will rebuild it as one.
  {% endhint %}

***

### Rolling updates

We're improving Data Apps continuously. As new capabilities land, we'll update this page.

***

### Getting help

Tell AskCorral, Claude, or ChatGPT to build, fix, or modify a Data App in plain language. For help debugging an existing one, share what's not working and the AI will diagnose and fix it.


---

# 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.corraldata.com/kb/explore-your-data/data-apps.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.
