Tables

Store, query, and manage structured data directly within your workspace

Tables let you store and manage structured data directly in your workspace. Use them to maintain reference data, collect workflow outputs, or build lightweight databases — all without leaving Sim.

Tables view showing structured data with typed columns for name, title, company, role, and more

Each table has a schema of typed columns, supports filtering and sorting, and is fully accessible through the Tables API.

Creating a Table

  1. Open the Tables section from your workspace sidebar
  2. Click New table
  3. Name your table and start adding columns

Tables start with a single text column. Add more columns by clicking New column in the column header area.

Column Types

Each column has a type that determines how values are stored and validated.

TypeDescriptionExample Values
TextFree-form string"Acme Corp", "hello@example.com"
NumberNumeric value42, 3.14, -100
BooleanTrue or falsetrue, false
DateDate value2026-03-16
JSONStructured object or array{"key": "value"}, [1, 2, 3]

Column types are enforced on input. For example, typing into a Number column is restricted to digits, dots, and minus signs. Non-numeric values entered via paste are coerced to 0.

Working with Rows

Adding Rows

  • Click New row below the last row to append a new row
  • Press Shift + Enter while a cell is selected to insert a row below
  • Paste tabular data (from a spreadsheet or TSV) to bulk-create rows

Editing Cells

Click a cell to select it, then press Enter, F2, or start typing to edit. Press Escape to cancel, or Tab to save and move to the next cell.

Selecting Rows

Click a row's checkbox to select it. Selecting additional checkboxes adds to the selection without clearing previous selections.

ActionBehavior
Click checkboxToggle that row's selection
Shift + click checkboxSelect range from last clicked to current
Click header checkboxSelect all / deselect all
Shift + SpaceToggle row selection from keyboard

Deleting Rows

Right-click a selected row (or group of selected rows) and choose Delete row from the context menu.

Filtering and Sorting

Use the toolbar above the table to filter and sort your data.

  • Filter: Set conditions on any column (e.g., "Name contains Acme"). Multiple filters are combined with AND logic.
  • Sort: Order rows by any column, ascending or descending.

Filters and sorts are applied in real time and do not modify the underlying data.

Keyboard Shortcuts

All shortcuts work when the table is focused and no cell is being edited.

Mod refers to Cmd on macOS and Ctrl on Windows/Linux.

ShortcutAction
Arrow keysMove one cell
Mod + Arrow keysJump to edge of table
Tab / Shift + TabMove to next / previous cell
EscapeClear selection

Selection

ShortcutAction
Shift + Arrow keysExtend selection by one cell
Mod + Shift + Arrow keysExtend selection to edge
Mod + ASelect all rows
Shift + SpaceToggle current row selection

Editing

ShortcutAction
Enter or F2Start editing selected cell
EscapeCancel editing
Type any characterStart editing with that character
Shift + EnterInsert new row below
SpaceExpand row details

Clipboard

ShortcutAction
Mod + CCopy selected cells
Mod + XCut selected cells
Mod + VPaste
Delete / BackspaceClear selected cells (all columns when using checkbox selection)

History

ShortcutAction
Mod + ZUndo
Mod + Shift + ZRedo
Mod + YRedo (alternative)

Using Tables in Workflows

Tables can be read from and written to within your workflows using the Table block. Common patterns include:

  • Lookup: Query a table for reference data (e.g., pricing rules, customer metadata)
  • Write-back: Store workflow outputs in a table for later review or reporting
  • Iteration: Process each row in a table as part of a batch workflow

API Access

Tables are fully accessible through the REST API. You can create, read, update, and delete both tables and rows programmatically.

See the Tables API Reference for endpoints, parameters, and examples.

Best Practices

  • Use typed columns to enforce data integrity — prefer Number and Boolean over storing everything as Text
  • Name columns descriptively so they are self-documenting when referenced in workflows
  • Use JSON columns sparingly — they are flexible but harder to filter and sort against
  • Leverage the API for bulk imports rather than manually entering large datasets

Common Questions

On this page

Start building today
Trusted by over 100,000 builders.
The open-source platform to build AI agents and run your agentic workforce.
Get started