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:
| Option | Description |
|---|---|
| Max Length | Limit characters (default: 255) |
| Pattern | Regex validation (advanced) |
| Prefix/Suffix | Add 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:
| Option | Description |
|---|---|
| Max Length | Limit characters (default: 5000) |
| Rows | Initial 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:
| Option | Description |
|---|---|
| Enable Images | Allow image uploads/embeds |
| Enable Tables | Show table editor |
| Enable Code Blocks | Syntax highlighting |
| Max Length | Character 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 addresses with validation and quick actions.
Configuration:
| Option | Description |
|---|---|
| Allow Multiple | Store multiple emails (comma-separated) |
| Validate Format | Require 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:
| Option | Description |
|---|---|
| Format | US, International, or Custom |
| Allow Multiple | Store multiple numbers |
| Default Country | Pre-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:
| Option | Description |
|---|---|
| Show Preview | Display link preview card |
| Validate URL | Require valid URL format |
| Open in New Tab | Default 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:
| Option | Description |
|---|---|
| Enable Autocomplete | Google Places integration |
| Show Map Preview | Display location on map |
| Required Components | Street, 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:
| Option | Description |
|---|---|
| Options | List of choices with labels |
| Colors | Assign color to each option |
| Default | Pre-selected value |
| Allow Other | Let users add custom options |
Creating Options:
- Click Add Option
- Enter the label
- Choose a color (optional)
- 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:
| Option | Description |
|---|---|
| Options | List of choices with labels |
| Colors | Assign color to each option |
| Min/Max | Limit 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:
| Option | Description |
|---|---|
| Default | Checked or unchecked |
| Label | Custom 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:
| Option | Description |
|---|---|
| Decimals | Number of decimal places (0-10) |
| Min/Max | Value range limits |
| Prefix/Suffix | Add units (e.g., "lbs", "units") |
| Negative | Allow negative numbers |
Best for: Quantities, scores, counts, measurements
Example: Quantity, Employee Count, Rating
Currency
Money amounts with currency formatting.
Configuration:
| Option | Description |
|---|---|
| Currency | USD, EUR, GBP, etc. |
| Decimals | Usually 2 for cents |
| Symbol Position | Before or after amount |
| Negative Format | Parentheses 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:
| Option | Description |
|---|---|
| Decimals | Number of decimal places |
| Min/Max | Usually 0-100 |
| Display | Show 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:
| Option | Description |
|---|---|
| Format | MM/DD/YYYY, DD/MM/YYYY, etc. |
| Min/Max Date | Restrict date range |
| Include Time | Convert 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:
| Option | Description |
|---|---|
| Date Format | Various formats available |
| Time Format | 12-hour or 24-hour |
| Timezone | User's timezone or specific |
| Default | Now, 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:
| Option | Description |
|---|---|
| Format | 12-hour or 24-hour |
| Step | Minute increments (1, 5, 15, 30) |
| Min/Max | Restrict 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:
| Option | Description |
|---|---|
| Include Time | Add time to dates |
| Allow Same Day | Start and end can be same date |
| Format | Date 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:
| Option | Description |
|---|---|
| Format | HH:MM, HH:MM:SS, or compact |
| Min/Max | Limit duration range |
| Show Days | Display 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:
| Option | Description |
|---|---|
| Max Rating | Number of stars/hearts (1-10, default 5) |
| Icon | Star or Heart |
| Half Values | Allow half ratings |
| Color | Icon 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:
| Option | Description |
|---|---|
| Show Percentage | Display % value |
| Color Thresholds | Change color at breakpoints |
| Min/Max | Default 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:
| Option | Description |
|---|---|
| Multiple | Allow multiple images |
| Max Images | Limit number of uploads |
| Max Size | File size limit (KB) |
| Show in Grid | Display 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:
| Option | Description |
|---|---|
| Target Module | Which module to link to |
| Allow Multiple | One-to-many or many-to-many |
| Display Field | Which field to show |
| Filter | Limit 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:
| Option | Description |
|---|---|
| Allow Multiple | Single or multiple assignees |
| Default | Current user, specific user, or empty |
| Filter by Team | Limit 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:
| Option | Description |
|---|---|
| Allow Multiple | Select multiple people |
| Source | Workspace members or specific team |
| Show Avatar | Display 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:
| Option | Description |
|---|---|
| Platforms | Limit to specific platforms |
| Multiple | Allow multiple profiles |
| Show Icons | Display 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:
| Option | Description |
|---|---|
| Allowed Types | Limit file extensions |
| Max Size | Per-file size limit |
| Max Files | Total files allowed |
| Storage | Cloud 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:
| Option | Description |
|---|---|
| Formula | Expression to evaluate |
| Output Type | Text, Number, Date, or Boolean |
| Decimals | For 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:
| Option | Description |
|---|---|
| Source | Reference field to aggregate |
| Field | Which field to roll up |
| Function | SUM, COUNT, AVG, MIN, MAX |
| Filter | Only 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:
| Option | Description |
|---|---|
| Prefix | Text before number (e.g., "INV-") |
| Suffix | Text after number (e.g., "-2024") |
| Start Number | Initial value (default: 1) |
| Padding | Zero-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
| Need | Use |
|---|---|
| Short text | Single Line |
| Long formatted text | Rich Text |
| One choice | Select |
| Multiple choices | Multi-select |
| Money | Currency (not Number) |
| Related record | Reference |
| Team member | User |
Next: Learn how to configure fields in detail or explore creating modules.