BYOB - Field Highlighter By Date (GA)

Published on February 9, 2026 BYOB

Field Highlighter By Date

Overview: Field Highlighter By Date automatically flags records based on how a Date field compares to today, for example opportunities closing this week or leads not contacted in the last 7 days, without writing a report or formula. The component checks the date on each record and applies highlighting whenever it falls within the range you define.

Before You Begin

1. The Build Your Own Branding (BYOB) package must be installed and active in your org.
2. The field you want to highlight on must be a Date field.
3. The field must already be present on the record layout you are configuring. If it is not on the layout, the component cannot read its value.
4. Enter just the field name (e.g., CloseDate) and do not prefix it with the object name.

Not supported: DateTime fields. They carry a time component that does not map cleanly to day-based ranges.

The component configuration panel, where you set the target Date field and condition.

Available Date Conditions

Example: If today is March 12, 2025: LAST_N_DAYS:6 matches March 6 to 12, NEXT_N_DAYS:6 matches March 12 to 18, LAST_WEEK matches March 2 to 8, and NEXT_WEEK matches March 16 to 22.

A date condition applied in the component visibility settings.

Worked Examples

Match: Today is March 12, 2025 and a record date is March 10, 2025. With LAST_N_DAYS:6, the record matches because March 10 falls within the last 6 days.

No match: Today is March 12, 2025 and a record date is March 5, 2025. With LAST_WEEK, the record does not match. Last week was March 2 to 8, and March 5 is outside that range only if the week boundaries differ, so always check the Sunday to Saturday window.

Edge case: Today is March 12, 2025 and a record date is March 17, 2025. With NEXT_WEEK, the record matches because next week runs March 16 to 22.

A record with the date-based highlight applied on the record page.

New in BYOB v1.35: Countdown Status Pills

What's new: In addition to highlighting a Date field with a solid color, the component can now render a subtle countdown tag or status pill next to the field value, for example "Due in 3 Days" in yellow or "Overdue by 1 Day" in bold red. Pills work with date parameters such as TODAY, TOMORROW, or LAST_WEEK.

Overdue example: A field showing an overdue message.

Screenshot of an Overdue message highlighting a field.

Pill-only mode: When the highlighter condition is for a due date, you can still set the field background and font colors as in the previous version, or leave them empty to apply only the pill status UX.

Pill status applied with the background and font colors left empty.

Due later: Example when the Close Date is due later.

Status pill shown when the Close Date is due later.

Use Cases

1. Critical data alerts: Highlight high-value opportunities closing soon, or leads with scores dropping into a risk range.
2. Renewal and follow-up reminders: Flag contracts renewing in the next 30 days, or contacts not reached in over a week.
3. SLA and deadline tracking: Surface cases or tasks approaching a due date so they do not get missed in a busy queue.

Console support: The component is fully supported in Salesforce Console navigation, so highlights display consistently on a standard record page or a Console tab.

Troubleshooting

Highlight not visible: Confirm the record meets the condition you set in Component Visibility. Double-check the date and the condition against the reference table above.

Date matching looks off: LAST_WEEK and THIS_WEEK follow a Sunday to Saturday schedule, not a rolling 7-day window.

Highlight missing entirely: Make sure the Date field is present on the record layout. If it is not, the component has no value to evaluate.

Knowledge Article Number: KA-00077