> ## Documentation Index
> Fetch the complete documentation index at: https://docs.consensus.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Extract data

> Extract data turns a set of papers into a table that Consensus fills in for you. Each paper is a row, each column is a question, and every answer links to the quote it came from.

[YouTube video player](https://www.youtube.com/embed/SisukwyizMI)

Extract data turns a set of papers into a table that Consensus fills in for you. Each paper is a row and each column is a question, like sample size or funding source. Consensus reads the papers, answers each cell, and shows you the quote behind every answer.

Use it to compare studies, pull the details you need for a literature review, or check what a set of papers reports, without opening every PDF yourself. Extract data is included on every plan.

## Start a table

There are three ways to create a table:

* **From search results.** Select the papers you want, then click **Extract data** at the bottom of the results.
* **From My Library or a Collection.** Select papers, then click **Extract data**.
* **From the sidebar.** Click **Extract data** under Tools, choose a blank table or a template, then add papers from My Library, upload files, or paste DOIs.

A table can hold up to 5,000 papers.

### Templates

Templates start your table with a set of columns already added.

| Template | Columns | Use it when |
| - | - | - |
| **Quick summary** | Key takeaway, Year, Journal, Authors | You want an overview of a set of papers |
| **PICO** | Population, Intervention, Comparison, Outcome measured | You're comparing clinical or intervention studies |
| **Study characteristics** | Study Design, Sample size, Population, Outcome measured | You're describing the studies in a review |
| **Critical appraisal** | Study Design, Sample size, Limitations, Funding or conflicts of interest | You're assessing the strength of each study |

## Add papers

Click **Add papers** at the top of the table and choose:

> [accordion] From My Library
>
> Pick saved papers or whole Collections.

> [accordion] Upload
>
> Upload PDF, RIS, or BibTeX files. Anything you upload is also saved to My Library. If you upload the PDF of a paper that's already in the table, it's added to that paper's row rather than creating a new one.

> [accordion] Paste DOIs
>
> Paste one or more DOIs. These papers are added to the table only, not to My Library.

## Add columns

Click **+ Column** in the table header to add a suggested column or create your own.

Extracted columns are answered by reading each paper, and use credits:

* Sample size
* Population
* Intervention
* Outcome measured
* Limitations
* Funding or conflicts of interest

Metadata columns come from the Consensus index rather than the paper itself. They're free and fill in right away:

* Authors
* Year
* Journal
* Citation count
* Full text?
* Key takeaway
* Study Design

Papers that aren't in the Consensus index, such as some uploads and dissertations, may have blank metadata columns.

### Create a custom column

**1. Open the column menu**

Click **+ Column**, then **Create custom column**.

**2. Name it and choose a format**

Pick **Free text**, **Number**, **Yes or No**, **Single tag**, or **Multiple tags**. For tag formats, list at least two possible values for Consensus to choose from.

**3. Write your question**

Type it under **Instructions**, the way you'd ask a colleague.

**4. Choose whether to require full text**

Turn on **Require full text** if the answer is unlikely to be in the abstract, such as details from the methods section. Otherwise, Consensus checks the abstract first.

Custom columns people create:

```text theme={null} theme={null}
How many participants were enrolled?
```

```text theme={null} theme={null}
Was the study preregistered?
```

```text theme={null} theme={null}
Which outcome measure was used for depression symptoms?
```

```text theme={null} theme={null}
What future areas of study do the authors suggest?
```

> [!TIP]
>
> Ask one question per column. Separate **Sample size** and **Mean age** columns will give you better answers than one column asking for both.

## How cells are filled

Consensus reads each paper's abstract first. If the abstract doesn't answer the question, it reads the full text. Columns with **Require full text** turned on, along with **Limitations** and **Funding or conflicts of interest**, go straight to the full text.

Every answer comes from a sentence in the paper about its own study, not from the other studies it cites. If the paper doesn't report something, the cell says so.

While the table fills, the header shows **Running M / N cells**. When it's done, a banner shows how many cells were filled.

### What each cell state means

| State | Meaning |
| - | - |
| **Found in abstract** / **Found in full text** | Answered, and where the answer came from |
| **Not found in abstract** / **Not found in full text** | Consensus read the paper and it doesn't report this |
| **Needs full text** | The answer is likely in the full text, but Consensus can't access it |
| **Not run** | The cell hasn't been run yet, usually because you've run out of credits |
| **Failed** | Something went wrong. Click **Run pending** to try again |
| **Needs credits** | You don't have enough credits to run this cell |

## Check an answer

Click any cell to see what Consensus read (the abstract, the full text, or both) and what it found. Click **View evidence** to see the supporting quotes in the paper.

## Add the full text yourself

Hover over a **Needs full text** cell. If a PDF is available through your library or open access, you'll see a link to it. If you have the PDF, click **Upload full text**. Consensus re-reads every **Needs full text** cell in that row for free, and saves the PDF to My Library.

Only the person who owns the table can upload full text.

## Filter and organize the table

Use the filters above the table to show only rows that are **Finished**, **Needs full text**, **Not run**, or **Failed**. A row can appear under more than one filter. To find a specific paper, search the table.

Open a column's menu to see how many of its cells are finished, running, or waiting, and to view, hide, or delete the column. Drag columns to reorder them.

## Cells and credits

Each extracted cell uses one credit, whether Consensus needs only the abstract or the full text too. Metadata columns are free, and so are re-reads after you upload full text.

| Plan | Extracted cells per month |
| - | - |
| Free | 100 |
| Pro | 500 |
| Teams | 500 |
| Enterprise | 500 |
| Deep | 10,000 |

**Run pending ⚡N**, in the table header or a column's menu, runs every cell that hasn't been answered yet or failed. N is the number of credits it'll use; hover over it to see the breakdown. If you don't have enough credits for every cell, Consensus fills as many as it can. Your credit balance is shown next to **Share**.

## Save, share, and export

* **Recents** — every table you create appears in **Recents** in the sidebar.
* **Save** — add a table to My Library or a Collection.
* **Export** — download the table as a CSV.
* **Share** — click **Share** and set the table to **Public** so anyone with the link can view it, or keep it **Private**.
* **Make a copy** — anyone who can view a table can copy it and keep working on their own version. Copying doesn't re-run any cells, so it uses no credits.

## Tables in a Deep Review

If you ask for a table during a [Deep Review](https://docs.consensus.app/core-features/deep-search.md), Research Agent can build an extraction table as part of its answer. The table appears as a card under the answer, and the answer cites its cells. These tables are read-only and don't appear in Recents. To edit one, open it and click **Make a copy**.

## Limits

* Each cell holds one answer per paper, so papers that report several studies or samples may not show all of them.
* Consensus only answers from text it can quote. Questions that depend on interpreting a whole paper, which is common with qualitative or theoretical work, may come back empty or with the closest related quote.
* Text answers are capped at about 2,000 characters, and columns asking Consensus to copy a paper's text word for word aren't allowed.

## Related

> [card] [Library](https://docs.consensus.app/core-features/library.md)
>
> Save papers and Collections to build tables from.

> [card] [Deep Review](https://docs.consensus.app/core-features/deep-search.md)
>
> Ask for a table and let Research Agent build it.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.