Docs Studio guide Schema & fields

Schema & fields

Studio is schema-first: you design your types and their fields before you create a single row. A file is bound to one schema type at creation, so getting the shape right up front saves you from reshuffling files later.

Field type reference

Studio schemas support these field types:

TypeRenders asNotes
textsingle-line input 
richtextMonaco Markdown editor with live previewMulti-line formatted text
numbernumeric inputSub-format: Decimal / Integer / Percent
currencynumeric input with currency code18 ISO currency codes to choose from
datedate picker 
datetimedate + time picker 
checkboxtoggletrue/false
selectsingle-choice dropdownYou define the option list
multiselectmulti-choiceSame option list mechanism as select
url / email / phonevalidated single-line input 
image upload + thumbnail Stored as a graxeon-asset:// reference, not inline. Supports "automated fields" — Width and Height are computed instantly; Description and Tags are filled in later by the enrichment worker.
videoupload + player 
pdf upload Same automated-fields mechanism as image — a Summary is computed instantly; Description and Tags are filled in later by enrichment.
markdownupload of a .md file 
filegeneric upload 
relation picker constrained to one schema type For a single typed reference (e.g. "Owner" on a Task, pointing only at Person). For open-ended, many-to-many connections, use links instead of a relation field.
Adding a field with "Include automated fields" checked (image/pdf only) appends read-only companion columns automatically — you don't hand-create those.

Designing the schema

  1. Toolbar → Edit schema. This opens a two-pane editor: a left list of every Schema (type) and Relationship Type in the collection, and a right pane for whichever one is selected.
  2. Click + next to "Schemas" → name the type (e.g. Company).
  3. + Add field for each column: name it, pick a type, set sub-options (format, currency, option list, target schema for relation), mark required if it must always be filled.
  4. Drag fields by the handle (☰) on the left of each row to reorder — this order is exactly the column order in the grid, so put the fields people scan first (name, status, owner) before the ones they don't (internal notes, IDs).
  5. Save schema.
  6. Repeat for every type you need. Do this before creating files — a file is bound to one schema type at creation.
  7. Optionally define Relationship Types here too (same left sidebar, "+" next to "Relationship Types") — gives a link a name that shows up in the picker instead of typing a custom one every time, and can optionally restrict which types it connects (From type / To type).