> For the complete documentation index, see [llms.txt](https://docs.docbits.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.docbits.com/administration-and-setup/settings/global-settings/document-types/table-columns.md).

# Table Columns

Table columns define which columns the line-item table of a document type has: what DocBits extracts into each column, what the user sees on the validation screen, and what is sent to the ERP on export.

**Where:** Settings → Document Processing → Document Types → Table Columns

<figure><img src="https://578966019-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FT2n2w4uDCJvv7CJ5zrdk%2Fuploads%2Fgit-blob-74d8fa19a9e7d8be5a99f4b7bd6dc0ab43954d9f%2Fstructured-output-column-choice-en-20261104.png?alt=media" alt="Current Use AI dropdown with Default, Yes and No. No option was changed. Title cells are hidden for privacy."><figcaption><p>Current Use AI dropdown with Default, Yes and No. No option was changed. Title cells are hidden for privacy.</p></figcaption></figure>

## What you see

Each row is one column of one table. The list shows:

| Column          | Meaning                                                                                                                                                                                                                           |
| --------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| **Column name** | Technical name, generated from the title (upper case, underscores). Used in scripts, export mappings and the API. Cannot be changed later.                                                                                        |
| **Title**       | Label shown on the validation screen. Change it with the translate icon in the *Actions* column (*Update translation key*).                                                                                                       |
| **Column Type** | `AMOUNT`, `STRING`, `DATE`, `NUMBER`, `BOOLEAN` or `CURRENCY`. Determines validation and formatting.                                                                                                                              |
| **Table name**  | The table the column belongs to, for example `INVOICE_TABLE`.                                                                                                                                                                     |
| **Is Required** | The document cannot be approved while this column is empty in any row.                                                                                                                                                            |
| **Read Only**   | Users see the value but cannot edit it.                                                                                                                                                                                           |
| **Hidden**      | The column is neither shown nor exported. Used to switch off default columns you do not need.                                                                                                                                     |
| **Use AI**      | Three-state AI selection: Default inherits the document-type AI default, Yes explicitly requests the column, and No excludes it from the base schema. This is separate from Required, Read Only and Hidden.                       |
| **Actions**     | Translate icon: rename the title. Info icon: where the shown label comes from (your translation, the default, the key). Three-dot menu: *Delete*, only for columns your organization created; default columns can only be hidden. |

Two buttons above the list:

* **Create new table**: a second line-item table for the document type (for example a charges table next to the item table).
* **Add new table column**: opens the dialog described in [Adding a new column](https://docs.docbits.com/administration-and-setup/settings/global-settings/document-types/table-columns/adding-a-new-column.md).

## Default columns and your own columns

Every document type ships with a set of default columns (for invoices: item number, description, quantity, unit price, total amount, tax, …). They belong to DocBits, not to your organization, so they cannot be deleted, hide them instead. Columns you add yourself belong to your organization and can be deleted.

{% hint style="info" %}
**Changes apply to new documents only.** A column you add, hide or delete appears on documents that are uploaded or restarted after the change. Documents already on the dashboard keep their table as it was extracted. Restart a document to pick up the new configuration.
{% endhint %}

## Related pages

* [Purpose and use](https://docs.docbits.com/administration-and-setup/settings/global-settings/document-types/table-columns/purpose-and-use.md): where table columns show up
* [Adding a new column](https://docs.docbits.com/administration-and-setup/settings/global-settings/document-types/table-columns/adding-a-new-column.md)
* [Editing and deleting columns](https://docs.docbits.com/administration-and-setup/settings/global-settings/document-types/table-columns/editing-and-deleting-columns.md)
* [Best practices](https://docs.docbits.com/administration-and-setup/settings/global-settings/document-types/table-columns/best-practices-2.md)
* [Troubleshooting](https://docs.docbits.com/administration-and-setup/settings/global-settings/document-types/table-columns/troubleshooting-1.md)
* [Training Line Fields / Table Training](https://docs.docbits.com/administration-and-setup/setup/document-training/training-line-fields-table-training.md): teach DocBits where a supplier's table is
* [AI Table](https://docs.docbits.com/end-user-and-partner-section/ai-table.md): what the user sees on the validation screen

## Use AI: Default, Yes or No

Open [Table Columns](https://docs.docbits.com/administration-and-setup/settings/global-settings/document-types/table-columns.md) for the correct document type and table. **Use AI** is a three-state dropdown, not a checkbox. Changes save immediately.

| Choice in the current menu                             | Meaning for the base schema                                                                                          |
| ------------------------------------------------------ | -------------------------------------------------------------------------------------------------------------------- |
| **Default · requested** or **Default · not requested** | Uses the DocBits default for this document type and column name. Default does not always mean on or always mean off. |
| **Yes · requested**                                    | Explicitly requests this configured column from the AI.                                                              |
| **No · not requested**                                 | Excludes it from the base schema even if it belongs to the default AI selection.                                     |

Returning to **Default** removes the explicit Yes/No choice. A newly created custom column normally does not belong to the default AI selection; set it to **Yes** if the AI should return it. Default AI columns are not the same as all built-in columns. Check the displayed effect and preview.

**Required**, **Read Only** and **Hidden** control completeness checks, editability and visibility. None replaces the AI choice. **No** neither deletes the column nor clears existing values and does not stop rules, scripts or other sources from filling it. Supplier training and additional AI tags can extend a run's request; resolve conflicting instructions there too. The Structured Output switch does not automatically replace a purely rule-based result.

[Structured Output for Tables](https://docs.docbits.com/end-user-and-partner-section/ai-table/structured-output.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://docs.docbits.com/administration-and-setup/settings/global-settings/document-types/table-columns.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.
