Data Model

Field Types

Create custom objects, fields, and structure your data.

Kantos supports a comprehensive set of field types. Choose the right type for proper validation, display formatting, and search behavior.

Basic Fields

TypeDescriptionUse Cases
TextSingle line of text (up to 255 characters)Names, titles, short descriptions
Long TextMulti-line text with no character limitNotes, descriptions, comments
NumberInteger or decimal valuesQuantities, scores, percentages
CurrencyMonetary values with formattingDeal values, budgets, prices
CheckboxBoolean true/false valueOpt-ins, flags, confirmations

Contact Fields

TypeValidationFeatures
EmailValid email format requiredClick to compose, deduplication
PhoneInternational phone formattingClick to call, auto-formatting
URLValid web address requiredClick to open, preview generation

Date & Time Fields

TypeFormatUse Cases
DateDate only (no time)Birthdays, deadlines, milestones
DateTimeDate with time and timezoneAppointments, events, timestamps

Selection Fields

TypeDescriptionUse Cases
DropdownSingle selection from predefined optionsStatus, category, priority
Multi-SelectMultiple selections allowedTags, interests, skills
StatusPipeline stages with colorsDeal stages, ticket status, lead status

Relationship Fields

TypeDescriptionUse Cases
LookupReference to another object (one-to-many)Contact → Company, Deal → Contact
Multi-LookupReferences to multiple records (many-to-many)Project → Team Members, Product → Categories
UserReference to a Kantos userOwner, assigned to, created by

Special Fields

TypeDescriptionUse Cases
FormulaCalculated value from other fieldsFull name, age, total value
RollupAggregation from related recordsTotal deal value, contact count
FileFile attachment storageDocuments, images, contracts

Creating Fields

Step

Open Object Settings

Navigate to the object you want to modify in Settings → Data Model.

Step

Click "Add Field"

Enter a field name and select the appropriate field type.

Step

Configure Field Options

Set options like required, unique, default value, and type-specific settings.

Step

Set Display Options

Choose whether to show in list view, detail view, and search results.

Step

Save Field

Click Save. The field is immediately available on all records.

Field Configuration Example

{
  "name": "Annual Revenue",
  "slug": "annual_revenue",
  "type": "currency",
  "options": {
    "currency": "USD",
    "required": false,
    "show_in_list": true,
    "show_in_detail": true,
    "searchable": false
  }
}

Best Practices

  • Choose the right type — Use Email for emails, not Text
  • Set sensible defaults — Pre-fill common values to speed data entry
  • Mark required fields — Only require truly essential data
  • Use dropdowns for consistency — Prevent typos with predefined options
  • Limit formula complexity — Complex formulas can slow down views
  • Index searchable fields — Only mark frequently searched fields as searchable

Next Steps

    Field Types - Data Model | Kantos Docs