> For the complete documentation index, see [llms.txt](https://help.metaforms.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.metaforms.ai/tabulations/tabulation-workspace.md).

# Tabulation Workspace

{% embed url="<https://www.youtube.com/watch?v=tNrOsZ7l4F0>" %}

The workspace is where you read, adjust and export your tables.

![The Tabulation workspace with the side list, a table and the Tabulation Agent](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-9566f2063683b9c1157e478fe414050edd84b25c%2Ftabulations-workspace-overview.png?alt=media)

### Top bar

The bar above the tables holds the controls for the whole deck.

![The top bar of the workspace](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-923a036aa8bfa7b9f24c2f03b8be963ee7e583ae%2Ftabulations-status-line.png?alt=media)

* **Banner** - choose which banner the tables are shown against, and manage banners.
* **Plan vN** - the current version of the deck. The number goes up as you make changes.
* **Files** - show or hide your data file and tab spec.
* **Compile** - rebuild the deck. While a build runs you can **Stop** it.
* **Export** - download the deck. See [Exporting Tables](https://help.metaforms.ai/tabulations/exporting-tables.md).

### Files

Click **Files** to open your uploaded files. For each file you can replace it, download it or remove it. The tab spec also has a version history button.

![The Files panel](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-0100c4f2a0ba03b0e3ca6b0ee20540725aef3073%2Ftabulations-files-panel.png?alt=media)

### Side list

The side list has two tabs.

* **Tables** - every table in the deck, with its number, ID and title. Use **Search tables...** to find one. Click a table to open it.
* **Variables** - every variable in your data, grouped by question. See [Global Configuration and Data Management](https://help.metaforms.ai/tabulations/global-configuration-and-data-management.md).

![The Tables tab of the side list](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-42d3f5d3978085585c3f4bb65a57337d149411c3%2Ftabulations-rail-tables.png?alt=media)

Tables that are not part of the tab spec are listed under **Not in tab spec**. A table can also carry a small badge such as custom, skipped, added, hidden from deck or validation warning.

Click the panel icon at the top of the list to close it, or use the toggle at the right of the status bar.

### Table view

The open table shows its title, base line and weight at the top. Use the arrows beside **Table 1 of 37** to move through the deck.

![A table in the workspace](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-ced457699017fce007c3388fd763014c815cc295%2Ftabulations-table-card.png?alt=media)

How to read a table:

* Each banner column has a letter: A, B, C and so on.
* The **Weighted Base** and **Unweighted Base** rows sit at the top.
* Each cell shows the count with the column percentage below it.
* A significance letter under a value names the column it differs from. Uppercase is the primary confidence level, lowercase the secondary.
* A value in amber with **!** has a low base.
* The footer shows which columns are tested and the minimum base. Click **N notes** to read the table's notes.

![The table footer with columns tested and notes](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-797dc8d6c0179d837f0d60877e5b322c1797d342%2Ftabulations-table-notes.png?alt=media)

Use the **Table display options** icon at the top left of the grid to choose which columns and rows you see on screen. The icon beside it expands the columns to fit their content.

![Table display options](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-1f840b081db3e4fd289627dcb82d6b720db22aa0%2Ftabulations-table-display-options.png?alt=media)

### Status bar

The bar at the bottom shows the data file, records and variables, the tab spec and the table count.

![The status bar](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-20dfa82a62b965858df6aa79ef12e628f5785dee%2Ftabulations-status-bar.png?alt=media)

Click the tab spec name to see its versions. Each row shows whether it was uploaded or edited by the agent, its plan version and a download button. You can download an earlier version, but not restore it.

![The Spec versions popover](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-ab2e91a1c3600fae4888c5c8e6129336c6062f25%2Ftabulations-spec-versions.png?alt=media)

### Right rail

The icons at the far right open three panels:

* **Tabulation Agent** - see [Using the Tabulation Agent](https://help.metaforms.ai/tabulations/using-the-dialing-agent-for-quick-table-setup.md).
* **Global Configuration** - see [Global Configuration and Data Management](https://help.metaforms.ai/tabulations/global-configuration-and-data-management.md).
* **What I can help with** - a list of things you can ask the agent.


---

# 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://help.metaforms.ai/tabulations/tabulation-workspace.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.
