Extra Fields
Extra Fields is a powerful customization feature that allows you to add your own custom Salesforce object fields to the Employee Hub and the Mobile App. This feature enables you to extend flair's functionality with organization-specific fields.
What Are Extra Fields?
Extra Fields are custom object fields that you create in Salesforce and configure to display in flair's Employee Hub. They allow you to:
- Add custom fields to forms and tables in the Employee Hub
- Control field visibility based on conditions like record types, form values, or context parameters
- Customize lookup references with dynamic SOQL filters
- Override field requirements independently of Salesforce field settings
- Define table structures for list views and detailed views
Key Concepts
Extra Fields come in two main types:
Extra Form Fields
Extra Form Fields (flair__Extra_Form_Field__mdt) define additional fields that appear in forms. They add fields to existing forms without replacing the default field set.
- Use for: Adding custom fields to expense forms, absence request forms, project forms, etc.
- Best for: Fields that need conditional visibility or custom validation rules
Extra Table Fields
Extra Table Fields (flair__Extra_Table_Field__mdt) define the complete table structure for list views. They control which columns appear and in what order.
- Use for: Customizing table columns in absence lists, expense lists, project lists, etc.
- Best for: Controlling what information is visible in list views
Supported Objects
Extra Fields support the following Salesforce objects:
- Expenses (
flair__Expense__c) - Absences (
flair__Absence__c) - Projects (
flair__Project__c) and (flair__Project_Time_Entry__c) - Time Entries (
flair__Time_Entry__c) — Add custom fields to time tracking forms and widgets (Employee Hub only) - Shift Planner — Add custom fields to the shift planner side panel (Employee Hub only)
- HelpDesk Tickets — Add custom fields to helpdesk ticket forms (Employee Hub only)
- Candidates (
flair__Candidate__c) — Add custom fields to candidate profiles in recruiting (Employee Hub only)
Where Are Extra Fields Displayed?
Extra Fields are displayed in:
- Employee Hub — Detailed views, forms, and widgets across all supported objects
- Mobile App — Absences
- Future support planned — Salesforce Custom Views
Getting Started
To start using Extra Fields:
- Create your custom field in Salesforce on the target object (e.g.,
flair__Expense__c) - Configure the Extra Field using Custom Metadata Types:
- For forms: Create a
Flair Extra Form Fieldrecord - For tables: Create a
Flair Extra Table Fieldrecord
- For forms: Create a
- Set visibility conditions (optional) to control when fields appear
- Configure lookup filters (optional) for reference fields
Next Steps
- Learn how to configure Extra Form Fields
- Learn how to configure Extra Table Fields