> 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/introduction-to-tabulations.md).

# Introduction to Tabulations

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

### Getting Started with Tabulation

Tabulation turns your data file and tab spec into a set of cross-tabulated tables, called the deck. You check and adjust the tables on screen, then export them to Excel. Follow these steps to build your first deck.

Tabulation is turned on per organization. If you open it and see "Tabulation is not enabled", contact your Metaforms administrator. To upload files and run a build, you need tabulation edit access.

Step 1: Click **New Project** to begin.

![The New Project button on the Projects page](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-9dcd0fe4d6b1c4ca2872d0a60d19515c5aea499d%2Ftabulations-new-project-button.png?alt=media)

Step 2: In **Create New Project**, choose a project type and enter a **Project Name**. **Project ID** is optional and is your own reference for tracking.

![The Create New Project dialog](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-9d07d3fd5d96b4b66f8016f72a10237bf7addd3c%2Ftabulations-new-project-dialog.png?alt=media)

Step 3: Click **Create Project**.

Step 4: Open **Tabulation** in the project's left menu.

![Tabulation in the project menu](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-9f0221f3fc835246bc748faac5efd430800a388a%2Ftabulations-project-nav-tabulation.png?alt=media)

Step 5: Upload your data file. Tabulation accepts `.sav`, `.xlsx` and Dimensions `.ddf` or `.dzf` files. Dimensions data also needs the study's `.mdd` metadata file, which you add in its own upload slot.

Step 6: Upload your tab spec. This step is optional, and the file can be `.xlsx`, `.xlsm` or `.docx`. Without a tab spec you get the standard tables only. You can add a spec at any time, or ask the Tabulation Agent to draft one from your data.

![The Run the tabs compiler page with the data file and tab spec upload slots](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-8f1f060164a8be00e9aa5103748efa175f13d4f9%2Ftabulations-upload-empty.png?alt=media)

Step 7: Click **Run tabs compiler**. The button stays disabled until the data file has finished uploading and processing.

Step 8: Watch the build in the panel on the right. It moves through five steps: Upload, Ingest, Spec parse, Mapping review and Tables.

![The Tabulation Agent panel with the build steps listed](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-5d495be5f95a7c9d9a5a7912b7c742636da497db%2Ftabulations-agent-empty.png?alt=media)

Step 9: If you have a tab spec, the build pauses at Mapping review so you can check how each spec row was matched. See [Reviewing the Tab Spec Mapping](https://help.metaforms.ai/tabulations/reviewing-the-tab-spec-mapping.md).

Step 10: When the build finishes, the workspace opens with your tables. See [Tabulation Workspace](https://help.metaforms.ai/tabulations/tabulation-workspace.md).

Step 11: Review the tables and adjust them directly, or ask the Tabulation Agent to make the change. See [Table Manipulation and Configuration](https://help.metaforms.ai/tabulations/table-manipulation-and-configuration.md) and [Using the Tabulation Agent](https://help.metaforms.ai/tabulations/using-the-dialing-agent-for-quick-table-setup.md).

Step 12: Click **Export** to download the deck as an Excel file. See [Exporting Tables](https://help.metaforms.ai/tabulations/exporting-tables.md).


---

# 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/introduction-to-tabulations.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.
