> 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/troubleshooting.md).

# Troubleshooting

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

### I cannot open Tabulation

"Tabulation is not enabled" means it is off for your organization. Contact your Metaforms administrator.

### I cannot upload or run a build

"You need tabulation edit access to upload files and run the compiler." means your role can view but not change this project.

**Run tabs compiler** stays disabled until the data file has finished uploading and processing. For Dimensions data, make sure the `.mdd` file is uploaded too.

If you see "Data file upload failed." or "Tab spec upload failed.", upload the file again.

### A build is stuck or I want to stop it

While a build runs, the panel on the right shows the current step, and **Stop** appears in the top bar. **Compile** is disabled, and tables that are being rebuilt show a **partial** badge.

![A running build with Stop in the top bar](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-3e121316a20bcf44c82c989c12468e98f4af037a%2Ftabulations-build-running.png?alt=media)

Click **Stop**. The panel shows **Stopped by you**, and nothing from that step is saved. Click **Retry** in the panel to run the step again.

![A step stopped by you, with Retry](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-724e3b02bdaae09023cb97686c2c3fe49283f8ee%2Ftabulations-build-failure-chip.png?alt=media)

Until you retry, tables from the stopped step show "This table couldn't be built" with the same message. Nothing in the plan needs fixing: click **Retry** in the panel.

![A table after the build was stopped](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-526d6acd0e71ad23d3f5553fc8c462fa66bb48f4%2Ftabulations-table-stopped.png?alt=media)

"Pipeline is running - stop it or wait" appears on buttons that stay locked until the build ends, such as uploads and edits.

If you see "Couldn't load the compiler pipeline state.", click **Retry**.

### A build failed

The build panel shows the step that failed, a label and a message, as in the picture above. Click **Retry**.

| Label               | Meaning                                                            |
| ------------------- | ------------------------------------------------------------------ |
| Limit exceeded      | The build went over a limit. Read the message for which one        |
| Out of disk         | There was not enough disk space to start the build                 |
| Storage unavailable | Storage could not be reached. Retry when it recovers               |
| Results missing     | Stored results are gone. Recompile                                 |
| Run stalled         | The build stopped responding                                       |
| Run superseded      | A newer change stopped this build before it finished. Run it again |
| Stopped by you      | You stopped this build. Nothing failed                             |

### A table did not build

One table can fail while the rest of the build succeeds. The side list marks it **table failed**, and the table shows "This table couldn't be built" with the reason. In this example, the top and bottom boxes share a code, so a respondent would be counted twice.

![A table that could not be built, with table failed in the side list](https://1402057010-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FgtHd8o9ldznZ1hKHiZvc%2Fuploads%2Fgit-blob-3684f7ec24a84fb62e7a6423e81f371eb2ced978%2Ftabulations-table-not-built.png?alt=media)

Fix what the message names, then click **Compile**. You can also click **Check again** to reload the table. Other wording you may see is "This table wasn't built" and "This table isn't available".

A failed table still has a place in the export, as a short block giving the reason. See [Exporting Tables](https://help.metaforms.ai/tabulations/exporting-tables.md).

### My deck is out of date

"Deck is from an older build" means your tables changed after the last export. Choose **Build & download deck** to refresh it.

### The build is waiting

**Review pending** means the build is waiting for your mapping review. See [Reviewing the Tab Spec Mapping](https://help.metaforms.ai/tabulations/reviewing-the-tab-spec-mapping.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/troubleshooting.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.
