---
sourceDocument: Yokohama Platform Analytics
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/now-intelligence

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Ranking records with Spotlight

# Ranking records with Spotlight {#ariaid-title1}

* Release version: Yokohama
* 
* Updated January 30, 2025
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Use Spotlight to identify and rank records of interest based on multiple weighted criteria.{#spotlight__ph_spotlight-shortdesc}

Spotlight illuminates records that otherwise you might overlook. You can define weighted criteria to identify and rank records that require attention, such as when triaging incidents or performing lead scoring. You can rank records based on multiple dimensions, instead of by a single field value such as priority. While most organizations address high-priority items in a timely manner, lower priority items sometimes are not addressed for an extended period of time. Spotlight helps you focus on items based on business need.

For example, you might want to have incidents brought to your attention if they have been open
for a long time, or been reassigned multiple times, even if these incidents are low priority.
Among those incidents, you might want one that has been open a long time and been assigned
multiple times to be ranked above one that has only been open a long time.

Spotlight uses scheduled jobs that run to evaluate the records. The results of these jobs can
be viewed in Spotlight interactive analyses. To share Spotlight results, share the URL of the
analysis with any user who has the pa_spotlight_viewer role.  
The following diagram demonstrates scoring in Spotlight. The large circle represents the set of all open incidents. Each of the smaller circles represents a weighted Spotlight criteria that applies to a subset of the open incidents.Figure 1. Spotlight diagram  
Note:  
To use Spotlight, an administrator must activate the Spotlight plugin.
* **[Setting up Spotlight](https://www.servicenow.com/docs/MfkVCPyChjZVPx4ZP1PYoQ)**   
  Set up Spotlight for each set of table records that you want to evaluate and rank by importance. The records must be associated with an indicator.
* **[See Spotlight score details](https://www.servicenow.com/docs/Wba1iponi1o2EfWImz0biw)**   
  To see the criteria whose weights contributed to a Spotlight score, view the details of the Spotlight record.
* **[Spotlight interactive analysis](https://www.servicenow.com/docs/GOPRRxAJa3hGkN3oapZAxA)**   
  Spotlight interactive analysis shows the key results of a Spotlight job. Access the analysis from a Spotlight Group record.
* **[Spotlights on Platform Analytics dashboards](https://www.servicenow.com/docs/KGJKW~BirZNZC1NBvb4ohA)**   
  You can list Spotlights and show them in a dashboard on a configurable workspace.
* **[Spotlight job logs](https://www.servicenow.com/docs/DquJWI4F7nU47ZKg_OpMcA)**   
  The steps of Spotlight jobs are recorded in logs. Use these logs to debug any issues.
* **[Domain separation with Spotlight](https://www.servicenow.com/docs/G7CFrC2hNxSpz9vmHGcbqg)**   
  If you have domain separation enabled, Spotlight applies it during Spotlight jobs.
* **[Copy a Spotlight group to domains](https://www.servicenow.com/docs/ZrOZV9gOtDI~qiBccnVXqw)**   
  You can copy a Spotlight group to other domains, saving the effort of reproducing the group manually for each domain.
* **[Copy a Spotlight group to breakdown elements](https://www.servicenow.com/docs/3qqgtcl~TmV6KcBm_tEGSQ)**   
  You can copy a Spotlight group across multiple elements of a single breakdown.
* **[Spotlight group copy logs](https://www.servicenow.com/docs/XzXr2DgeBFDdzU~LW~ywiQ#spotlight-copy-logs)**   
  When a Spotlight group is copied, the steps of the copying process are recorded in logs. Use these logs to debug any issues.
* **[Administering Spotlight](https://www.servicenow.com/docs/SzZLFsSCZRJjKRuyRSB2LQ)**   
  Users with the admin role can access lower-level components of Spotlight.