Field Types

Complete reference for the field types available in Fyso.

text

Short single-line text.

• Storage: string
• Config: none
• Example value: "Juan Perez"

textarea

Long multi-line text.

• Storage: string
• Config: none
• Example value: "Long description\nwith line breaks"

number

Numeric value (integer or decimal).

• Storage: number
• Config: none
• Example value: 150.50

email

Email address.

• Storage: string
• Config: none
• Example value: "juan@example.com"

phone

Phone number.

• Storage: string
• Config: none
• Example value: "+54 11 1234-5678"

date

Date (without time).

• Storage: string (ISO format YYYY-MM-DD)
• Config: none
• Example value: "2026-02-18"

boolean

True/false value.

• Storage: boolean
• Config: none
• Example value: true

select

Selection from a predefined list of options.

• Storage: string (the value of the selected option)
• Config:

Config	Type	Description
options	string[] or {value, label}[]	Available options

• Config example:

{
  "options": ["activo", "inactivo", "pendiente"]
}

Or with labels:

{
  "options": [
    { "value": "active", "label": "Activo" },
    { "value": "inactive", "label": "Inactivo" }
  ]
}

• Example value: "activo"

relation

Reference to a record in another entity.

• Storage: string (UUID of the related record)
• Config:

Config	Type	Description
relatedEntity	string	Name of the related entity

• Config example:

{
  "relatedEntity": "clientes"
}

• Example value: "6bd2d1db-d104-4a15-977a-a759c38608a9"

When querying records with resolve=true, the relation is expanded to the full record.

file

File attachment. Uploaded using the upload_file tool.

• Storage: object

{
  "key": "uploads/file.pdf",
  "url": "/files/file.pdf",
  "name": "file.pdf",
  "size": 1024,
  "mimeType": "application/pdf"
}

• Config:

Config	Type	Description
accept	string[]	Allowed MIME types (e.g., ["image/*", "application/pdf"])
maxSize	number	Maximum size in bytes
multiple	boolean	Allow multiple files. Default: false
maxFiles	number	Maximum files when multiple=true

• Config example:

{
  "accept": ["image/*", "application/pdf"],
  "maxSize": 5242880,
  "multiple": false
}

location

Geographic location with coordinates and optional address data.

• Storage: object

{
  "lat": -34.6037,
  "lng": -58.3816,
  "address": "Av. 9 de Julio 1000",
  "city": "Buenos Aires",
  "country": "Argentina"
}

• Config:

Config	Type	Description
displayFormat	string	"map", "text", or "both" (default: "both")
defaultZoom	number	Initial map zoom (1-20, default: 13)
defaultCenter	object	Initial center: { lat: number, lng: number }

• Config example:

{
  "displayFormat": "both",
  "defaultZoom": 15,
  "defaultCenter": { "lat": -34.6037, "lng": -58.3816 }
}

Type Summary

Type	Stores	Required Config
text	string	-
textarea	string	-
number	number	-
email	string	-
phone	string	-
date	string	-
boolean	boolean	-
select	string	options
relation	string (UUID)	relatedEntity
file	object	accept, maxSize, multiple
location	object	displayFormat, defaultZoom