Grid82
grid82.comJoin the waitlist
BuildField types

Field types

All 28 field types in Grid82, their storage rules, configuration options, character limits, and wire formats.

A field’s type defines what values are valid, how the grid renders and formats cells, and how the query engine stores and filters records. Clicking + in the Studio header opens the field configuration dialog to pick a type and its settings.

Studio add field configuration dialog

Configuring a new field's type and constraints in the Studio

Text types

TypeBest forMax sizeNotes
textTitles, short labels, IDs500 charsDefault single-line string
longtextNotes, descriptions, transcripts125,000 charsStored raw without formatting changes
emailContact addresses254 charsAccepts supplied text; flags suspect formats in API warnings
urlWebsite links2,048 charsAccepts supplied text; flags suspect formats in API warnings
phoneTelephone numbers32 charsOptional default country setting
jsonStructured payloads from webhooks or tools125,000 charsMust parse as valid JSON; cannot be filtered or sorted by nested keys

Number types

TypeBest forSettingsWire rule
numberCounts, quantitiesprecision, thousands, negatives, prefix, suffixStored as a finite number
currencyMoney, deal valuescode (ISO 4217), position, precision, negativesStored as decimal value (48000 for €48,000)
percentProbabilities, discountsprecisionStored as a fraction: 0.15 represents 15%
ratingPriority, scoremax (3, 5, or 10), icon, tintInteger from 0 to max
durationTime spent, SLAsformatStored in milliseconds: 1 hour is 3600000

Choices, booleans, and people

  • select and multiselect. Options are { id, label, tint }. Cells store option IDs (opt_...), never display labels, so renaming an option’s label updates every record immediately. You can pass up to 50 selected options in a multiselect cell.
  • Named tints. Options, ratings, checkboxes, and buttons use Grid82’s 11 named tints: blue, green, amber, yellow, orange, red, pink, violet, indigo, gray, and teal.
  • checkbox. Stores a boolean (true / false) with optional icon and tint. Writes also accept 1/0, yes/no, or on/off.
  • user. Points to one member (single: true) or up to 50 members (single: false) from the app, optionally restricted to specific roles. Reads back as [{ id, label }]; accepts user ID, email, or exact name on write.

Dates and attachments

  • date. Stores ISO 8601 timestamps in UTC. config.time controls whether the field stores a time component (datetime) or calendar date; timeZone, display, and clock affect presentation only.
  • attachment. Stores up to one (single: true) or multiple files uploaded to managed file storage (accept filters allowed extensions like .pdf). Reading a record returns short-lived signed url properties alongside { id, name, size, mime, key }. Never cache the signed URL permanently; fetch records fresh when downloading bytes.

Automatic stamps

The engine populates six read-only system types automatically (writes to them are ignored):

recordId (rec_...), autonumber (sequential integer per record), createdTime, createdBy, modifiedTime, and modifiedBy.

modifiedTime and modifiedBy support config.watch (an array of field IDs) so the stamp updates only when specific columns change.

Relational, computed, and action types

  • link, lookup, and rollup. Connect tables and aggregate fields across links. See Formulas and relations.
  • formula. Evaluates expressions over fields in the same record (up to 2,000 chars, 10 nesting levels).
  • button. Computes a dynamic URL (config.url formula) rendered as an actionable button (label, tint, variant) with no stored value.

Use these docs with your AI tools

An AI agent can read this documentation directly. You do not need an account or an API key. Everything here is public and read-only.

Query these docs via MCP

Recommended

Add this server to Claude, Claude Code, Cursor, Mistral, or any tool that supports MCP. Your agent can then search Grid82 documentation and read it in full, instead of answering from memory.

https://grid82.com/docs/mcp
  • searchFind the passages that answer a question.
  • fetchRead one page in full, as Markdown.
  • list_pagesSee every page in this documentation.

Query these docs over HTTP

The same tools also work as plain web requests. Use this for scripts, or for any tool that does not support MCP. There is one endpoint per tool. Arguments go in the query string, and the answer comes back as JSON.

https://grid82.com/docs/api/docs/search?query=custom+domain

Read the OpenAPI description. It is built from the same definitions as the tools, so it always matches what the endpoints do.

Read these docs as Markdown

Add .md to any page URL to get its Markdown source. You can also send the headerAccept: text/markdown to the page URL itself.

To read the whole documentation in one file, open llms-full.txt. For a short index of every page, open llms.txt.