Field Types Reference

Complete reference for all field types and their configuration options

Field Types Reference

This reference covers every field type available in Coherence, including configuration options and best practices for each.

Text Fields

Single Line Text

Basic text input for short content.

Configuration:

OptionDescription
Max LengthLimit characters (default: 255)
PatternRegex validation (advanced)
Prefix/SuffixAdd static text before/after

Best for: Names, titles, short identifiers, SKUs

Example: Contact Name, Product Title, Order Number


Multi Line Text

Paragraph text without formatting.

Configuration:

OptionDescription
Max LengthLimit characters (default: 5000)
RowsInitial display height (2-10 rows)

Best for: Plain text notes, comments, basic descriptions

Example: Internal Notes, Short Description


Rich Text

Full-featured editor with formatting capabilities.

Features:

  • Headings (H1-H3)
  • Bold, italic, underline, strikethrough
  • Bullet and numbered lists
  • Links and images
  • Code blocks
  • Tables
  • Embedded content

Configuration:

OptionDescription
Enable ImagesAllow image uploads/embeds
Enable TablesShow table editor
Enable Code BlocksSyntax highlighting
Max LengthCharacter limit (optional)

Best for: Long-form content, documentation, detailed notes

Example: Meeting Notes, Project Description, Support Ticket Details

Rich Text fields support paste from Google Docs, Notion, and Word with formatting preserved.


Contact Fields

Email

Email addresses with validation and quick actions.

Configuration:

OptionDescription
Allow MultipleStore multiple emails (comma-separated)
Validate FormatRequire valid email format

Quick Actions:

  • Click to compose in Coherence
  • Right-click to copy
  • Auto-link for email sync

Best for: Contact emails, work emails, personal emails


Phone

Phone numbers with formatting and click-to-call.

Configuration:

OptionDescription
FormatUS, International, or Custom
Allow MultipleStore multiple numbers
Default CountryPre-fill country code

Quick Actions:

  • Click to call (if supported)
  • Click to open in phone app
  • Copy to clipboard

Best for: Mobile, work phone, fax numbers


URL

Website links with preview and validation.

Configuration:

OptionDescription
Show PreviewDisplay link preview card
Validate URLRequire valid URL format
Open in New TabDefault link behavior

Quick Actions:

  • Click to open link
  • Preview shows title and favicon
  • Auto-detect social profiles

Best for: Websites, LinkedIn profiles, documentation links


Address

Structured location data with autocomplete.

Configuration:

OptionDescription
Enable AutocompleteGoogle Places integration
Show Map PreviewDisplay location on map
Required ComponentsStreet, City, State, etc.

Components Stored:

  • Street address
  • City
  • State/Province
  • Postal code
  • Country
  • Latitude/Longitude (auto-filled)

Best for: Office addresses, shipping addresses, locations

Address fields with coordinates can be used to calculate distances and show on map views.


Selection Fields

Select (Single)

Choose one option from a predefined list.

Configuration:

OptionDescription
OptionsList of choices with labels
ColorsAssign color to each option
DefaultPre-selected value
Allow OtherLet users add custom options

Creating Options:

  1. Click Add Option
  2. Enter the label
  3. Choose a color (optional)
  4. Drag to reorder

Best for: Status, priority, type, category

Example: Status (Lead, Qualified, Customer), Priority (Low, Medium, High)


Multi-Select

Choose multiple options from a list.

Configuration:

OptionDescription
OptionsList of choices with labels
ColorsAssign color to each option
Min/MaxLimit number of selections

Display:

  • Shows as colored badges/pills
  • Filterable in views
  • Groupable in reports

Best for: Tags, categories, skills, features

Example: Tags (Hot Lead, VIP, Partner), Skills (JavaScript, Python, SQL)


Checkbox

Simple true/false toggle.

Configuration:

OptionDescription
DefaultChecked or unchecked
LabelCustom display text

Best for: Flags, yes/no questions, feature toggles

Example: Is Active, Email Verified, NDA Signed


Numeric Fields

Number

Integer or decimal values.

Configuration:

OptionDescription
DecimalsNumber of decimal places (0-10)
Min/MaxValue range limits
Prefix/SuffixAdd units (e.g., "lbs", "units")
NegativeAllow negative numbers

Best for: Quantities, scores, counts, measurements

Example: Quantity, Employee Count, Rating


Currency

Money amounts with currency formatting.

Configuration:

OptionDescription
CurrencyUSD, EUR, GBP, etc.
DecimalsUsually 2 for cents
Symbol PositionBefore or after amount
Negative FormatParentheses or minus

Display: Properly formatted with symbols and separators

Best for: Deal values, prices, budgets, revenue

Example: Deal Value, Monthly Revenue, Budget

Currency fields can be summed in rollup fields and reports for totals.


Percentage

Values displayed as percentages.

Configuration:

OptionDescription
DecimalsNumber of decimal places
Min/MaxUsually 0-100
DisplayShow with % symbol

Storage: Stored as decimal (0.5 = 50%)

Best for: Probabilities, completion rates, discounts

Example: Win Probability, Completion %, Discount Rate


Date & Time Fields

Date

Calendar date selection.

Configuration:

OptionDescription
FormatMM/DD/YYYY, DD/MM/YYYY, etc.
Min/Max DateRestrict date range
Include TimeConvert to Date & Time

Picker: Interactive calendar dropdown

Best for: Due dates, start dates, birthdays

Example: Due Date, Start Date, Contract Date


Date & Time

Date with time selection.

Configuration:

OptionDescription
Date FormatVarious formats available
Time Format12-hour or 24-hour
TimezoneUser's timezone or specific
DefaultNow, specific time, or empty

Best for: Appointments, scheduled events, timestamps

Example: Meeting Time, Appointment, Created At


Time

Time-only field without a date component.

Configuration:

OptionDescription
Format12-hour or 24-hour
StepMinute increments (1, 5, 15, 30)
Min/MaxRestrict time range

Best for: Business hours, daily schedules, recurring times

Example: Opening Time, Closing Time, Daily Standup


Date Range

Start and end date pair for durations.

Configuration:

OptionDescription
Include TimeAdd time to dates
Allow Same DayStart and end can be same date
FormatDate display format

Storage: Stored as { start, end } object

Best for: Project timelines, event durations, booking periods

Example: Project Duration, Event Dates, Vacation Period


Duration

Time span in hours, minutes, seconds.

Configuration:

OptionDescription
FormatHH:MM, HH:MM:SS, or compact
Min/MaxLimit duration range
Show DaysDisplay days for long durations

Input: Hours/minutes/seconds or total minutes

Best for: Time tracking, meeting lengths, task estimates

Example: Time Spent, Meeting Duration, Estimated Hours


Visual Fields

Rating

Star or heart-based rating input.

Configuration:

OptionDescription
Max RatingNumber of stars/hearts (1-10, default 5)
IconStar or Heart
Half ValuesAllow half ratings
ColorIcon fill color

Display: Filled icons for rating value

Best for: Customer ratings, quality scores, satisfaction levels

Example: Customer Rating, Quality Score, Priority


Progress

Visual progress bar with percentage.

Configuration:

OptionDescription
Show PercentageDisplay % value
Color ThresholdsChange color at breakpoints
Min/MaxDefault 0-100

Color Thresholds:

  • 0-33%: Red (danger)
  • 34-66%: Yellow (warning)
  • 67-100%: Green (success)

Best for: Completion tracking, goal progress, capacity

Example: Task Progress, Goal Completion, Project Status


Image

Image upload with gallery and lightbox.

Configuration:

OptionDescription
MultipleAllow multiple images
Max ImagesLimit number of uploads
Max SizeFile size limit (KB)
Show in GridDisplay thumbnail in table view

Features:

  • Drag-and-drop upload
  • Thumbnail grid preview
  • Full-screen lightbox viewer
  • Navigation between images

Best for: Product photos, profile pictures, attachments

Example: Product Image, Profile Photo, Property Photos

Image fields support JPG, PNG, GIF, and WebP formats. Use the Gallery view to showcase records with images.


Relationship Fields

Reference

Link to records in another module.

Configuration:

OptionDescription
Target ModuleWhich module to link to
Allow MultipleOne-to-many or many-to-many
Display FieldWhich field to show
FilterLimit available records

Relationship Types:

  • One-to-One: Contact → Primary Company
  • One-to-Many: Company → Multiple Contacts
  • Many-to-Many: Deal → Multiple Contacts

Best for: Connecting related data across modules

Example: Company (on Contact), Primary Contact (on Deal)


User

Assign to workspace team members.

Configuration:

OptionDescription
Allow MultipleSingle or multiple assignees
DefaultCurrent user, specific user, or empty
Filter by TeamLimit to specific teams

Features:

  • Shows user avatar and name
  • Filterable by assignee
  • Triggers notifications

Best for: Ownership, assignments, created by

Example: Owner, Assigned To, Created By


Person

Link to workspace members with avatar display.

Configuration:

OptionDescription
Allow MultipleSelect multiple people
SourceWorkspace members or specific team
Show AvatarDisplay profile picture

Features:

  • Searchable user picker
  • Avatar chips display
  • "+N more" badge for multiple

Storage: Stores { userId, displayName, email, avatar } object

Best for: Assignees, reviewers, participants, mentions

Example: Assigned To, Reviewers, Meeting Attendees


Social Profile

Social media profiles with platform detection.

Configuration:

OptionDescription
PlatformsLimit to specific platforms
MultipleAllow multiple profiles
Show IconsDisplay platform icons

Supported Platforms:

  • LinkedIn, Twitter/X, Facebook
  • Instagram, GitHub, YouTube
  • TikTok, Dribbble, Behance
  • Website, and more

Features:

  • Auto-detects platform from URL
  • Brand-colored icons
  • Click to open profile
  • Username extraction

Best for: Contact social links, influencer profiles

Example: LinkedIn Profile, Twitter Handle, Social Links


Media Fields

Attachment

File uploads and storage.

Configuration:

OptionDescription
Allowed TypesLimit file extensions
Max SizePer-file size limit
Max FilesTotal files allowed
StorageCloud storage location

Supported Files:

  • Documents: PDF, DOC, DOCX, XLS, XLSX
  • Images: JPG, PNG, GIF, SVG
  • Other: ZIP, CSV, any file type

Features:

  • Drag-and-drop upload
  • Preview for images and PDFs
  • Download and share links

Best for: Contracts, images, documents, proposals


Computed Fields

Formula

Calculate values from other fields.

Configuration:

OptionDescription
FormulaExpression to evaluate
Output TypeText, Number, Date, or Boolean
DecimalsFor numeric output

Operators:

  • Math: +, -, *, /, %
  • Comparison: >, <, >=, <=, ==, !=
  • Logical: AND, OR, NOT

Functions:

// Text
CONCAT(first_name, " ", last_name)
UPPER(name)
LEFT(text, 5)

// Math
SUM(field1, field2)
ROUND(number, 2)
ABS(number)

// Date
DATEDIFF(date1, date2)
DATEADD(date, 30, "days")
TODAY()

// Logic
IF(condition, true_value, false_value)
ISBLANK(field)

Best for: Calculated totals, derived values, status logic


Rollup

Aggregate data from linked records.

Configuration:

OptionDescription
SourceReference field to aggregate
FieldWhich field to roll up
FunctionSUM, COUNT, AVG, MIN, MAX
FilterOnly include matching records

Examples:

  • Total Deal Value from linked Deals
  • Count of Contacts per Company
  • Average Order Value

Best for: Totals, counts, averages from related records


System Fields

Auto-Number

Automatic sequential numbering for records.

Configuration:

OptionDescription
PrefixText before number (e.g., "INV-")
SuffixText after number (e.g., "-2024")
Start NumberInitial value (default: 1)
PaddingZero-pad to length (e.g., 001)

Behavior:

  • Automatically assigned on record creation
  • Unique and never reused
  • Cannot be manually edited
  • Survives record deletion (gaps preserved)

Best for: Invoice numbers, ticket IDs, order numbers

Example: Invoice # (INV-0001), Ticket # (TICK-001), Order # (ORD-2024-0001)

Use prefixes to identify record types at a glance. Combine with year for date-aware numbering.


Field Best Practices

Naming Conventions

  • Use clear, descriptive names
  • Be consistent across modules
  • Avoid abbreviations

✅ Good: Deal Value, Primary Contact, Created Date ❌ Bad: val, contact1, dt

When to Use Each Type

NeedUse
Short textSingle Line
Long formatted textRich Text
One choiceSelect
Multiple choicesMulti-select
MoneyCurrency (not Number)
Related recordReference
Team memberUser

Next: Learn how to configure fields in detail or explore creating modules.