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

# Columns

> Add, configure, map, filter, sort, run, and manage Table columns.

Columns define what each row stores or produces. Start with text inputs, then add computed columns for each step in the workflow.

For the full list of supported types, see [Column Types](/features/tables/column-types).

## Add a column

Click **Add Column** to add a new field to the sheet.

<Frame>
  <img src="https://mintcdn.com/promptlayer/BTziw3aguOQDZPlm/images/tables/polished/05-add-columns.png?fit=max&auto=format&n=BTziw3aguOQDZPlm&q=85&s=2dbe77d72094ee6b92baf333eaa0a8c5" alt="Add Column control in a Table sheet" width="1920" height="1080" data-path="images/tables/polished/05-add-columns.png" />
</Frame>

A clear sheet usually moves left to right: inputs, generated outputs, checks or helper transforms, and reviewer notes.

## Choose a computed type

Use one computed column per logical step: prompt or workflow execution, code, deterministic checks, LLM evaluation, helper transforms, or composition.

<Frame>
  <img src="https://mintcdn.com/promptlayer/BTziw3aguOQDZPlm/images/tables/polished/06-column-types.png?fit=max&auto=format&n=BTziw3aguOQDZPlm&q=85&s=b754a2d2fb74c82f04ef0f5da24f2e53" alt="A Table with input columns followed by computed prompt, code, quality, and edge-case columns" width="1920" height="1080" data-path="images/tables/polished/06-column-types.png" />
</Frame>

## Configure a column

Open a column menu and choose **Configure column** to edit its settings.

<Frame>
  <img src="https://mintcdn.com/promptlayer/jIkQ2KU6cJGL355R/images/tables/polished/22-add-column-menu.png?fit=max&auto=format&n=jIkQ2KU6cJGL355R&q=85&s=3fca8d1b35e092ef5201dd4c237dbeb0" alt="Column menu showing Configure column, Hide, Auto size, Pin, Filter, Sort, Run column, Stop column, Duplicate, and Delete actions" width="1920" height="1080" data-path="images/tables/polished/22-add-column-menu.png" />
</Frame>

Use the same menu to hide, resize, pin, filter, sort, run, duplicate, or delete a column.

## Map sources

Computed columns read from source columns. A Prompt Template column, for example, exposes the prompt's input variables and lets you map each variable to a source column.

<Frame>
  <img src="https://mintcdn.com/promptlayer/BTziw3aguOQDZPlm/images/tables/polished/07-source-mapping.png?fit=max&auto=format&n=BTziw3aguOQDZPlm&q=85&s=9397bed56acd7a18ce1494b8229719a8" alt="Prompt Template column configuration showing input variables mapped to source columns" width="1920" height="1440" data-path="images/tables/polished/07-source-mapping.png" />
</Frame>

Source mappings become dependencies. When a source value or computed column configuration changes, dependent computed cells can become stale.

If a variable is unmapped, open the source selector and choose the source column for that variable.

## Filter and sort columns

Use **Filter** to narrow visible rows by column value. Use **Sort ascending**, **Sort descending**, and **Clear sort** to reorder or reset the grid.

## Pin, hide, resize, duplicate, and delete columns

Use column menu actions to manage grid layout:

* **Pin left** or **Pin right** keeps important columns visible while scrolling.
* **Hide** removes a column from the visible grid without deleting it.
* **Auto size column** resizes a column to fit visible content.
* **Duplicate** copies a column when you want a similar configuration.
* **Delete** removes the column.

## Run or stop a column

Use **Run column** when one computed step needs updating. If the column is queued, dispatched, or running, the menu can show **Stop column**.

## Use composition columns

Composition columns reference another sheet or table and pull values from a chosen source column. Use composition when multiple sheets should share a reusable intermediate result instead of copying logic into every sheet.

<Frame>
  <img src="https://mintcdn.com/promptlayer/BTziw3aguOQDZPlm/images/tables/polished/12-composition.png?fit=max&auto=format&n=BTziw3aguOQDZPlm&q=85&s=95c21a81d65ff893d6cd66c8a42dbcaa" alt="Composition column configuration that copies values from a source column in another sheet" width="1920" height="1440" data-path="images/tables/polished/12-composition.png" />
</Frame>

## API references

<CardGroup cols={2}>
  <Card title="Create column" icon="plus" href="/reference/table-sheet-columns-create">
    Add a text or computed column to a sheet.
  </Card>

  <Card title="Update column" icon="pen" href="/reference/table-sheet-columns-update">
    Update a column title, config, or dependencies.
  </Card>

  <Card title="List columns" icon="list" href="/reference/table-sheet-columns-list">
    List columns for a sheet.
  </Card>

  <Card title="Run operation" icon="play" href="/reference/table-sheet-operations-create">
    Queue work for a column, row, cell selection, or stale cells.
  </Card>
</CardGroup>
