---
sourceDocument: Xanadu Platform Analytics
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/xanadu/now-intelligence

 Release :

    - xanadu

ft:locale :

    - en-US

ft:publication_title :

    - Xanadu Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Create Spotlight criteria

# Create Spotlight criteria {#ariaid-title1}

* Release version: Xanadu
* 
* Updated August 1, 2024
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Create Spotlight criteria to define when to weight a record, and the weight to
assign.

## Before you begin

[Create a Spotlight group](https://servicenow-prod.fluidtopics.net/e4VN_L5iJfOBj~GEjptUqA#create-spotlight-group "Create a Spotlight group to define the records to evaluate. In the Spotlight group, you also set the threshold that the score of a record must exceed to trigger the creation of a Spotlight.")

Role required: pa_spotlight or
admin

## About this task

Spotlight criteria define how to weight records based on specific attributes. Each Spotlight criterion is associated with a Spotlight Group.  
Spotlight criteria can refer to an indicator or can use a direct query to the facts table. The former criteria are called indicator-based criteria and the latter are called query-based criteria. The indicator for an indicator-based criterion must meet the following requirements:

* It must be an automatic indicator.
* It must be set to collect records.
* It must be based on the same table that the indicator source of the main indicator is based on. This table cannot be a database view.
* If the Spotlight group evaluates platform data, the indicator cannot use a scripted breakdown.
{#create-spotlight-criteria__ul_pt5_1wz_5db}

A query-based criterion queries the same table that the indicator source
of the main indicator is based on. The suitability of indicator-based and
query-based criteria depends also on whether the Spotlight group evaluates platform
data or snapshots of records. For more information, see [Evaluating a snapshot or platform data](https://servicenow-prod.fluidtopics.net/e4VN_L5iJfOBj~GEjptUqA#using-snapshot-or-real-time-data "When a Spotlight job runs, it either evaluates a snapshot of collected records or it collects and evaluates data directly from the platform.").

Some criteria may be more important than others and have a higher weight. Weight from
multiple criteria is cumulative within a Spotlight Group. The score of a record is
the total weight from all applicable Spotlight criteria in the Spotlight
Group.  
If you have domain separation enabled:

* When you create Spotlight criteria for a global Spotlight group, the criteria are created in the domain of the logged-in user.
* When you create Spotlight criteria for a Spotlight group that is in a specific domain, the Spotlight criteria are created in that domain.

{#create-spotlight-criteria__ul_ws2_tjq_hhb}Messages appear to inform you of the domain situation when you create Spotlight criteria. For more information, see [Domain separation with Spotlight](https://servicenow-prod.fluidtopics.net/HPbO8DzdwEVXKYs3GEmlww "If you have domain separation enabled, Spotlight applies it during Spotlight jobs.").

## Procedure

1. In a Spotlight group record, locate the Spotlight Criteria related list and click New. {#create-spotlight-criteria__step_spotlight-group}
{#create-spotlight-criteria__step_spotlight-group}
2. Enter the Weight you want to assign to records that meet this criterion.  
   Consider revisiting the Threshold value that is set in the associated Spotlight group. Optimize the weights of the Spotlight criteria of the group and the group threshold against each other. {#create-spotlight-criteria__cmd_weight}
3. Select the Criteria Type to determine which records are assigned the specified weight.

   | Option | Description |
   | Indicator | Select an Indicator to assign the weight to all records included in that indicator. Optionally, select one or two breakdowns and elements to limit the records to only those records with the specified breakdown element values. |
   | Query | Set Filter conditions. The specified weight is assigned to all records from the facts table that match the filter conditions. The facts table of the main indicator of the Spotlight group is automatically selected. |
   |-|-|

   {#create-spotlight-criteria__choicetable_gw3_tvp_bx} {#create-spotlight-criteria__step_spotlight-criteria-type}
{#create-spotlight-criteria__step_spotlight-criteria-type}
4. Click Submit.

## Result

You have a criterion for a Spotlight group.

## Spotlight group with three criteria

Consider a Spotlight Group with the following three criteria, all referring to indicators:

* Open incidents not updated in 30 days, with a weight of 1000.
* Reassignment \> 3 times, with a weight of 800
* Description is Empty, with a weight of 300
{#create-spotlight-criteria__ul_dlr_fwb_r2b}In this example, an open incident that has been reassigned 4 times and has an empty Description field has a total score of 1100. This incident is prioritized above an incident that has not been updated in 30 days, which has a total score of 1000.

## What to do next

Repeat the procedure to create as many criteria as are necessary. Then collect scores. See [Collect Spotlight scores](https://servicenow-prod.fluidtopics.net/4ght8mrKOMysbz4NezLvIQ "To collect Spotlight scores, schedule score collection and activate the Spotlight group. You can also collect scores manually for an active Spotlight group.").