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

# Columns and processors

Every column in a grid runs a **processor**. This page covers adding a column, wiring it to other columns, and controlling when it runs.

## Add a column

Click **Add Column** at the right end of the header row (**⌘L**), or right-click a header to insert one beside it. Pick a processor from the pane, by category or through the search box, fill in its settings, and click **Add To Grid**. Every processor is cataloged under [Processors](/grids/processors/overview).

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/qx-labs/ANUEumuRP1AOjziU/images/grids/columns-and-processors/processor-pane-light.png?fit=max&auto=format&n=ANUEumuRP1AOjziU&q=85&s=e63da8e6cbf87a5688ce23ecbb4a501b" alt="The processor pane with categories and search, next to a column's settings" width="1000" height="700" data-path="images/grids/columns-and-processors/processor-pane-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/grids/columns-and-processors/processor-pane-dark.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=1438f6dab0b7a2ea6b4d612af935f1fc" alt="The processor pane with categories and search, next to a column's settings" width="1000" height="700" data-path="images/grids/columns-and-processors/processor-pane-dark.png" />
</Frame>

## Reference other columns

Type `/` in any of a processor's input fields to insert a column. A picker opens listing your columns, each with a preview of its value, and the one you choose drops in as a chip. Columns that hold rich objects let you drill in and pick a single field.

<Frame>
  <img className="block dark:hidden" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/grids/columns-and-processors/column-reference-light.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=6d14c03a9a57c4bc0e69bc265303dbac" alt="The column picker that opens when you type / in a processor field" width="760" height="480" data-path="images/grids/columns-and-processors/column-reference-light.png" />

  <img className="hidden dark:block" src="https://mintcdn.com/qx-labs/ZJkiVX6zo-84vXkk/images/grids/columns-and-processors/column-reference-dark.png?fit=max&auto=format&n=ZJkiVX6zo-84vXkk&q=85&s=379269f21039cde873f4c55ec11b6d47" alt="The column picker that opens when you type / in a processor field" width="760" height="480" data-path="images/grids/columns-and-processors/column-reference-dark.png" />
</Frame>

This is how columns chain. A research column can take your company name and website columns as its input, and when those values change, the research is marked to run again.

## Control when a column runs

Open **Run Settings** in the column's settings to run it only when a condition is true. The condition works like a Python expression, for example `${revenue} > 1000`, and you insert columns into it with `/` just like anywhere else. Rows where the condition is false show the **Skipped** status and cost nothing.

To try several sources in order and keep the first result, use the **Waterfall** processor, see [Advanced processors](/grids/processors/advanced).

## Credits

Each processor shows an amber credits pill in its settings, so you can see the cost per cell before adding it. AI processors are metered by usage, so run a few rows first to gauge the cost. See [Plans and credits](/getting-started/plans-and-credits).

## Manage columns

Double-click a header to rename a column, and drag headers to reorder them. Right-click a header for **Edit config**, **Insert column left** or **right**, **Duplicate**, **Sort A → Z** or **Z → A**, and **Delete column**. Use **Freeze columns** in the toolbar to pin the first few while you scroll.
