This guide provides an in-depth understanding of the configuration options for a planner component, which can be used to create various scheduling and planning interfaces. We will explore the various fields and values involved in the setup process and provide examples for each configuration option.
Version 6 upgrade notes and what's-new highlights are in Tips so this index stays 1:1 with configuration lines.





-1 for Auto Height (component automatically expands to show all records without a scrollbar).
250 to 2000 (fixed height in pixels)-1 → Auto Height (recommended for most use cases)
-1 to ensure all child records are visible without scrolling inside the component.600 → fixed height of 600px-1 → auto-expands to fit all recordsYESNONO.YES when onboarding new users or sharing the component with stakeholders who may not know the color meanings.
Active Tasks by Status → displays this text as the component headingHIDETITLE option on line #16).12 → small, discreet title18 → default / medium size24 → large and prominent titleEVENT → shows the Event iconTASK → shows the Task iconOPPORTUNITY → shows the Opportunity icon
TODAY as ActivityDate to always highlight the current dayId, Name, ActivityDate, IsAllDay, StartTimeInMinutes, EndTimeInMinutes, IsRecurrence, RecurrenceType, RecurrenceEndDateOnly, colorRecursDaily, RecursEveryWeekday, RecursWeekly, RecursMonthly, RecursYearlyRed or #ff6666[{
"Id":"today001",
"Name":"Today",
"ActivityDate":"TODAY",
"IsAllDay":true,
"color":"#e3f2fd"
}][
{"Id":"h1","Name":"Christmas","ActivityDate":"2025-12-25","IsAllDay":true,"color":"#d32f2f"},
{"Id":"h2","Name":"Team Meeting","ActivityDate":"TODAY","StartTimeInMinutes":540,"EndTimeInMinutes":600,"IsRecurrence":true,"RecurrenceType":"RecursWeekly","color":"#4caf50"},
{"Id":"h3","Name":"Summer Break","ActivityDate":"2025-08-01","IsAllDay":true,"IsRecurrence":true,"RecurrenceType":"RecursYearly","color":"#fff176"}
]TODAY is used and Component Start Date (line #21) is also set to TODAY.# to the object name to add an “Unassigned / Blank” column for records where the lookup is empty.UserAccount#Field__c:blue:20:white (field, background, font size, font color).UserDepartmentAccountBillingCity
No → No automatic filtering (shows all records from the Matrix Timeline Sobject)PageID → Shows only the record that matches the current record page ID (perfect when the component is placed on a record detail page)UserID → Shows only the column for the currently logged-in userUser fields → Dynamically matches any field on the Matrix Sobject to the corresponding field on the current user (e.g., Department, Location, ManagerId)UserIDPageIDUser fieldsUserID for personal views and PageID when embedding the component on a record page. Combine with Component Matrix Timeline Field to show additional context (e.g., Role, Location).
User fields.Parent_Field_API_Name__c, User_Field_API_NameDepartment__c, DepartmentCompany__c, CompanyIsActive = TRUE AND Profile.Name = 'Sales Rep'(IsActive = TRUE) ORDER BY Name ASCORDER BY FieldName at the end if needed.
150 → Compact view (good for many columns)300 → Spacious view (better readability)

HOUR, DAY, WEEK, MONTH, YEAR, HEADERLESS, DATELESS, ARROWLESS, NOGLOBALFILTER, NOEXPORT, EXPORTCONFIG, NOFILTERCHILDSBYDATES, CATCHEXPORTCONFIG
HEADERLESS → Removes entire top header (date picker + view buttons)DATELESS → Hides date navigation pickerARROWLESS → Removes left/right date arrowsNOGLOBALFILTER / NOEXPORT → Hides those buttonsEXPORTCONFIG → Enables export of current config (PSV format). Use it for backup before upgrades or when copying a pack.NOFILTERCHILDSBYDATES (6.23+) → Keeps child records visible even when their dates fall outside the current timeline range. For date-timeline types (GANTT, SCHEDULER, and their HIDDEN PARENTS variants). May increase initial load time. Do not use on GRID, GRID - KANBAN, MATRIX, or MATRIX - KANBAN.CATCHEXPORTCONFIG (6.37+) → On a runtime error, exports the configuration and queries for troubleshooting. Use in real time (not edit mode). Send the downloaded file to support.NOSHADOWS → Remove record, group-by and popup shadows (replaces NOBACKDROPSHADOW; from 6.28 also clears the popup shadow)HOUR, DAY, WEEK, MONTH, YEAR → Removes that timeline scaleHOUR, HEADERLESS with Component Title left emptyHIDETITLE, FULLSCREEN and NOHYPERLINK are no longer used. Leave Component Title empty to hide the title and icon, fullscreen is always shown next to the Hide/Show Header button, and record-page links are controlled by NOPARENTRECORDPAGE / NORECORDPAGE on line #34.

WEEK → Opens in weekly view by defaultDAY → Ideal for detailed daily planningTODAY-based Component Start Date (hourly view with TODAY start).DYNAMIC (and RANGE/DYNAMIC) mode.


HOUR for an hourly view that starts on TODAY.TODAY, holidays configured on line #9 (including TODAY highlight) render correctly.DYNAMIC or RANGE/DYNAMIC.


CLONE → Show Clone button (child records)HOVER → Show extra tile fields when hovering over a record tile (from 6.37 the hover delay is longer to reduce accidental popups)DELETE → Show Delete button (child records)FLOW → Show Flow launch button (uses Flow names defined in config lines #49, #72 & #95)NOEDIT → Hide Edit button on child popupsNOLINK → Disable clickable links in Gantt dependency linesNOPARENTEDIT → Hide Edit button on parent record popupsPARENTCLONE → Enable Clone for parent recordsPARENTDELETE → Enable Delete for parent recordsPARENTFLOW → Show Flow button on parent popupsNORECORDPAGE → Remove “Open Record” button and block opening the child record page, including on double-clickNOPARENTRECORDPAGE → Block opening the parent record page, including the parent name link and double-clickINVERSECOLORS → Advanced popup color control.FOREGROUNDCOLOR → Advanced popup color control.BACKGROUNDCOLOR:color → Set popup background (e.g., BACKGROUNDCOLOR:#caf0f8 or BACKGROUNDCOLOR:lightcyan)BORDERWIDTH:# → Set border thickness in pixels (e.g., BORDERWIDTH:2)BORDERCOLOR:color → Set border color (e.g., BORDERCOLOR:black)WIDTH### → Force popup width in pixels (e.g., WIDTH800)CLONE, DELETE, FLOW, HOVERHOVER, NOEDIT, NORECORDPAGE, BACKGROUNDCOLOR:#f0f8ff, BORDERWIDTH:1, BORDERCOLOR:#007bffNOPARENTEDIT, PARENTCLONE, PARENTDELETENORECORDPAGE / NOPARENTRECORDPAGE also block double-click open. The hamburger menu on the popup is hidden when no actions are available.


PARENT AND CHILDS.
FieldAPI__c, [Service=lightgreen,Support=#ffb703]
Status__c [In Progress=#2196f3,Completed=#4caf50,On Hold=#ff9800"]Product_Family__c
Crew__c pointing to a Crew custom objectCrew__c instead of the usual Account/Campaign/Opportunity lookupStatus__c = 'Active' AND Priority__c = 'High'Licenses_Type__c INCLUDES ('Sales','Service')StageName IN ('Closed Won','Closed Lost')Status__c = 'Active' AND Job_Title__c IN ('{!Engineer_Job_Title}'.replace(';', "',''))Status__c = 'Active' AND Job_Title__c IN ('"+SUBSTITUTE({!Engineer_Job_Title}, ";", "' , '")+"')
Id = '001xx000003DI8e' OR Id = '001xx000003DI9f'WHERE. Use exact API names and proper quoting. Test complex conditions in SOQL Builder first.
FlowApiName#Custom Label# and a label to customize the Flow button text. Example: CreateCaseFlow#New Case.PARENTFLOW (or the matching parent Flow option) to display the flow button on the parent popup.% to the field API name to show the picklist label instead of the stored API value.Status__c% → displays "In Progress", "Completed", etc.FieldAPIName:bgColor:fontSize:fontColorStatus__c:#3686C9:20:black → blue background, 20px font, black textStageName:#28a745::white → green background, default size, white textPriority__c::18: → only increase font size to 18pxStatus__c%:#3686C9:18:whiteStageName:#10B981:20:whiteStatus__c%:#6366F1:18: shows picklist labels with a custom purple header and 18px font.
In_Progress, Completed → these columns will not appear.
!!Not_Started, In_Progress → only these two columns will be shown; everything else is hidden.
# to explicitly include or exclude records where the timeline field is empty.#!Prospect, Customer - Direct, # → shows only Prospect, Customer - Direct, and blank records.
Not_Started, On_Hold!Not_Started, In_Progress, Review!Customer - Direct, Prospect, #% symbol is used on the Timeline Field.
name__c^YourLabel$ to include a label on title fields (see title-field format notes above for ^ custom labels).Case__c#Subject.
Case__c#Subject when the related object has no Name field).
Field__c,[-- None --=#f4faff,Planner=blue]

[{'key': 'Field Value', 'value': 'Color'}][{'key': 'Field Value', 'value': 'Color', 'font': 'Color'}][{'key': 'Displayed Label', 'value': '#FF0000', 'api': 'actual_api_value'}]
aujourd\'hui or Women\'s Category
[{'key': 'High', 'value': '#FF0000'}, {'key': 'Medium', 'value': '#FFA500'}, {'key': 'Low', 'value': '#00FF00'}][
{'key': 'In Progress', 'value': 'yellow', 'font': 'black'},
{'key': 'Completed', 'value': '#00CC00'},
{'key': 'On Hold', 'value': '#FFCC00', 'font': 'black'},
{'key': 'Cancelled', 'value': '#FF3333'}
]FlowApiName#Custom Label# and a label to customize the Flow menu label. Example: CreateCaseFlow#New Case. Open Flow appears under the popup ≡ (overflow) menu, not as a free-standing header icon.FLOW to show Open Flow in the popup menu.
% to the field API name to show the picklist label instead of the stored API value.Status__c% → displays "In Progress", "Completed", etc.FieldAPIName:bgColor:fontSize:fontColorStatus__c:#3686C9:20:black → blue background, 20px font, black textStageName:#28a745::white → green background, default size, white textPriority__c::18: → only increase font size to 18pxStatus__c%:#3686C9:18:whiteStageName:#10B981:20:whiteStatus__c%:#6366F1:18: shows picklist labels with a custom purple header and 18px font.name__c^YourLabel[{'key': 'Field Value', 'value': 'Color'}][{'key': 'Field Value', 'value': 'Color', 'font': 'Color'}][{'key': 'Displayed Label', 'value': '#FF0000', 'api': 'actual_api_value'}]
aujourd\'hui or Women\'s Category
[{'key': 'High', 'value': '#FF0000'}, {'key': 'Medium', 'value': '#FFA500'}, {'key': 'Low', 'value': '#00FF00'}][
{'key': 'In Progress', 'value': 'yellow', 'font': 'black'},
{'key': 'Completed', 'value': '#00CC00'},
{'key': 'On Hold', 'value': '#FFCC00', 'font': 'black'},
{'key': 'Cancelled', 'value': '#FF3333'}
]FlowApiName#Custom Label# and a label to customize the Flow button text. Example: CreateCaseFlow#New Case.PARENT AND CHILDS to allow creating new parent records when clicking empty space. PARENT AND CHILDS needs a Parent sObject set and replaces the retired PARENTCREATE. When the parent is User, BOTH is usually the better choice, because creating Users from empty space is rarely wanted.