How Spotlights Work

Purpose
Spotlight Selection
What Each Spotlight Shows
Feed Cadence and Dismissal
Data and Timing Considerations
Important To Remember
Related Articles

Purpose

This article explains how Spotlights are selected, formatted, and delivered to your feed, and what to keep in mind when reviewing them.

Spotlight Selection

Spotlights are generated through a structured process each month:

Candidate pool. Spotlight candidates are generated from your Metrics based on trigger conditions.
Pre-selection. The top candidates are selected using a score-based process that balances domain diversity.
Weekly assignment. At least one selected Spotlight is surfaced for you in Practice.
Formatting. Each Spotlight is formatted with a short, plain-language title and descriptive text framing the insight clearly and without jargon.

Data Quality Gate

Spotlights only surface from data that meets a completeness threshold of approximately 85%. If your data does not yet meet this threshold for a given period, no Spotlight will be generated for that period.

What Each Spotlight Shows

A category label indicating the domain: patients, medications, procedures, utilization, care coordination, outcomes, or finance
A short title describing the insight
One to two lines of context covering the Metric, time period, and comparison group
The time period the Spotlight analyzed

Feed Cadence and Dismissal

Cadence

At least one new Spotlights are surfaced each week
Up to 16 Spotlights may be available in your feed at any one time
Each Spotlight expires four weeks after it is surfaced, regardless of whether you have viewed or dismissed it
Historical Spotlights are retained in the database for reference after they expire from the active feed

Dismissal

When you dismiss a Spotlight, the card is greyed out and moved to the end of the carousel. It remains visible until it expires naturally after four weeks. You can undo a dismissal to return the card to its original position in the feed.

Data and Timing Considerations

Claims Data Lag

Open and closed commercial claims may take up to six months to become fully available. Medicare, Medicaid, and QE data may take up to nine months to surface.

Important To Remember

Spotlights reflect correlations in your data, not causation.
Peer group matching is based on your self-selected specialty and location. Make sure your specialty reflects the benchmark group you should be in. Highly specialized subspecialists may have limited peer comparison groups.
Specialty relevance varies. Some Metrics may not be directly applicable to your practice, even if they fall within your specialty category.
Spotlights do not reflect current clinical activity. All data has an inherent lag.
New accounts may not see Spotlights immediately. Spotlight generation runs after signup data is processed — typically within 10 to 20 minutes — but full coverage builds over time as more data accumulates.

Version History

Updated: May 6, 2026

Reviewed by: Claude, Help Scout Docs Reviewer

Approved by: [Name, Title]