Skip to content

Field Types

SmartTable provides a rich set of field types across 9 categories. Each type is designed for a specific kind of data and comes with its own configuration options.

Field Type Overview

CategoryField TypeDescription
Text TypesSingle Line TextShort text input with validation rules
Text TypesLong TextLong text/paragraph input with multi-line editing
Text TypesRich TextHTML rich text editor with formatting support
Numeric TypesNumberInteger/decimal with number/currency/percent formatting
Date TypesDateDate picker supporting multiple date formats
Date TypesDate TimeDateTime picker accurate to seconds
Selection TypesSingle SelectDropdown single select with custom options and colors
Selection TypesMulti SelectTag-style multi select with custom options
Selection TypesCheckboxBoolean toggle
People TypesMemberUser selection with current-user default value
Contact TypesPhonePhone number input and formatted display
Contact TypesEmailEmail address input and validation
Contact TypesURLURL link with click-to-navigate
Media TypesAttachmentFile upload/download with image preview and thumbnails
Computed TypesFormula47 built-in functions with field references and nested calculations
Relation TypesLinkTable relationships supporting one-to-one/one-to-many/many-to-many
Lookup TypesLookupCross-table queries with aggregation (sum/avg/count/etc.)
System TypesCreated ByAuto-record record creator
System TypesCreated TimeAuto-record creation timestamp
System TypesUpdated ByAuto-record last modifier
System TypesUpdated TimeAuto-record last modification time
System TypesAuto NumberAuto-increment with prefix/suffix/date format/padding
OthersRatingStar rating component
OthersProgressProgress bar/percentage display

Choosing a Field Type

Pick the type that matches how the data will be entered, displayed, and calculated. For example, use Single Select for statuses, Link for relationships, and Formula for computed values.

Common Configuration

Most fields support the following settings:

  • Field Name — Display name of the column.
  • Field Description — Help text shown to collaborators.
  • Required — Whether the field must contain a value.
  • Default Value — Value applied automatically to new records.
  • Validation Rules — Length, range, regex, or format checks.

Text and Numeric Fields

Single Line Text

Short text such as names or titles. Supports maximum length and regex validation.

Long Text

Multi-line text for descriptions and notes. Supports line breaks and Markdown rendering.

Rich Text

HTML rich text with formatting such as bold, lists, links, and tables.

Number

Integers or decimals. Configure decimal places, minimum/maximum values, and display format (number, currency, or percentage).

Date and Selection Fields

Date / Date Time

Choose dates or date-times from a picker. Support multiple display formats.

Single Select / Multi Select

Choose from predefined options. Set custom colors and default options. Multi Select displays values as tags.

Checkbox

A simple true/false toggle. Useful for completion flags.

People, Contact, and Media

Member

Reference system users or team members. Supports single or multiple selection and can default to the current user.

Phone / Email / URL

Validated contact fields. URLs are clickable and open in a new tab.

Attachment

Upload images, documents, and other files. Supports previews, thumbnails, and downloads.

Computed and Relational Fields

Formula

Calculate values using 47 built-in functions. Reference other fields and nest functions for math, text, date, logic, and statistics.

javascript
{Unit Price} * {Quantity}

IF({Score} >= 90, "Excellent", IF({Score} >= 60, "Pass", "Fail"))

Create relationships between records in the same or different tables. Supports one-to-one, one-to-many, and many-to-many relationships.

Lookup

Pull values from linked records and aggregate them with sum, average, count, and more.

System Fields

System fields are managed automatically:

FieldPurpose
Created ByUser who created the record
Created TimeTimestamp when the record was created
Updated ByUser who last modified the record
Updated TimeTimestamp of the last modification
Auto NumberAuto-incrementing ID with optional prefix, suffix, date format, and padding

Released under the MIT License.