> For the complete documentation index, see [llms.txt](https://knowledge.out-smart.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://knowledge.out-smart.com/marketplace-packages-and-power-ups/power-ups/forms/configure-table-fields-in-forms.md).

# Configure table fields in Forms

Table fields help you collect repeated values in one structured block.

Use them when employees need to register several related values in rows or columns.

### What table fields are good for

Use a table field when you need to capture:

* measurements across multiple points
* checklist values in a fixed structure
* quantities, totals, or repeated inspection entries

### What you can configure

A table field lets you control:

* the table name
* whether the table is mandatory
* horizontal or vertical orientation
* fixed values and fill-in cells
* values pulled in from OutSmart

{% stepper %}
{% step %}

### Open the form

Go to **Settings → Forms**.

Open an existing form or create a new one.
{% endstep %}

{% step %}

### Add a table field

Add the **Table** field.

The configuration opens right away.
{% endstep %}

{% step %}

### Choose the structure

Enter a clear name.

Choose whether the table is mandatory.

Then choose **Horizontal** or **Vertical**.
{% endstep %}

{% step %}

### Add rows or columns

Use **Add option** to build the table.

Leave cells empty when employees should fill them in.
{% endstep %}

{% step %}

### Add fixed or automatic values

Use **Edit values** when you want to prefill cells.

You can add tags to pull in customer, company, or object data.
{% endstep %}

{% step %}

### Save and test

Save the form.

Then test the table on a work order and in the PDF output.
{% endstep %}
{% endstepper %}

### How orientation works

**Horizontal** tables usually treat each row as one entry.

**Vertical** tables usually treat each column as one entry.

Choose the layout that matches how employees read and complete the form.

### FAQ

<details>

<summary>Can I make a table field mandatory?</summary>

Yes.

Employees must complete the required table before they can submit the form.

</details>

<details>

<summary>Can a table fill values automatically?</summary>

Yes.

You can use tags to pull values from OutSmart into the table.

</details>

<details>

<summary>Should I test the PDF layout too?</summary>

Yes.

Tables can look different in the app and in PDF output.

</details>

### Related topics

* [Create a form](/marketplace-packages-and-power-ups/power-ups/forms/create-a-form.md)
* [Form field types](/marketplace-packages-and-power-ups/power-ups/forms/form-field-types.md)
* [Use calculations in Forms](/marketplace-packages-and-power-ups/power-ups/forms/use-calculations-in-forms.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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://knowledge.out-smart.com/marketplace-packages-and-power-ups/power-ups/forms/configure-table-fields-in-forms.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

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.