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

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Platform Analytics

ft:clusterId :

    - par

bundleId :

    - par

workflow :

    - Platform


---

# Create a breakdown mapping on a breakdown record

# Create a breakdown mapping on a breakdown record {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read

Specify which field on the indicator source references the breakdown source. If no
appropriate field is available, specify a script to query the indicator source.

## Before you begin

Assign a breakdown source to the breakdown before creating the mapping.

Role required: The same as for creating a breakdown.

## About this task

You can create multiple mappings for the same breakdown, enabling you to use that breakdown for multiple indicators.  
Note:  
The procedure on this page uses a related list on the breakdown form. You can instead use a graphical tool that you access from the indicator form. See [Assign and map breakdowns](https://www.servicenow.com/docs/zeG44wSDslFhnPLO09pjmA#create-breakdown-mapping "Select which breakdowns to assign to an indicator. Map which field on the indicator source references the breakdown source. If no appropriate field is available, specify a script to associate the indicator and breakdown sources.").

## Procedure

1. If you are adding a mapping to an existing breakdown, find that breakdown in the relevant list of breakdowns and open it.
2. In the Breakdown Mapping related list, click New.
3. Select the Facts table.  
   This table is the indicator source that you want to break down. {#t_CrtBkdnBreakdownMpngs__step_o1g_cmb_mdb}
{#t_CrtBkdnBreakdownMpngs__step_o1g_cmb_mdb}
4. Do one of these actions.

   | Option | Description |
   | Use a field to map values to elements. | Select the Field in the indicator source that maps to records in the breakdown. See the use of the Category field in [Example: Field mapping](https://www.servicenow.com/docs/U0HzrUzaMTkpnKUWtSOeNg "The Category breakdown maps the Category field on the incident table to the Incident.Category breakdown source, which references the Choices[sys_choice_list] table."). |
   | Use a script to map values to elements. | Select Scripted, then select the Script that defines the association between indicator records and breakdown elements. Use a script when you do not have the simple use case of a field in the indicator source that maps to a breakdown source table. A script can define a wide range of mapping relationships. The most common use case is when the breakdown source is a [bucket group](https://www.servicenow.com/docs/0BmHD84G7z5nj9ylwlJX_g#gloss-bucket-group "Gathers continuous data into discrete groups when there is no table field that can serve as breakdown elements. For example, a bucket group might take differences between timestamps and divide them up into hourly periods.") and the script returns an integer to assign an indicator score to a bucket. See [Example: Script mapping](https://www.servicenow.com/docs/VnBSDC2hBZUEk2n9Uy_bAQ "The Age breakdown uses the Incident.Age.Days script to calculate the age of incidents in days and map the values to the Incident Age Ranges bucket group."). You cannot show real-time scores for an indicator that uses a scripted breakdown. Tip: Try to implement scripted breakdown mappings so that \[mapping of level 1 \&\& mapping of level 2\] is equal to the intersection of \[mapping of level 1\] and \[mapping of level 2\]. Otherwise, the score and the number of records may not agree for second-level breakdowns. If these values disagree, the score is correct. For more details and an example, see [KB0748969](https://support.servicenow.com/kb?id=kb_article_view&sysparm_article=KB0748969). Now Support login is required. |
   |-|-|

   {#t_CrtBkdnBreakdownMpngs__choicetable_vmj_4t3_twb} {#t_CrtBkdnBreakdownMpngs__step_jjl_cmb_mdb}
{#t_CrtBkdnBreakdownMpngs__step_jjl_cmb_mdb}
5. Click Submit.
6. Repeat steps 2--5 as needed, to define additional mappings. {#t_CrtBkdnBreakdownMpngs__step_mny_cmb_mdb}
{#t_CrtBkdnBreakdownMpngs__step_mny_cmb_mdb}{#t_CrtBkdnBreakdownMpngs__steps_xhq_qdd_4s}
**Previous topic:** [Create an automated breakdown](https://www.servicenow.com/docs/3m9ObB~NT_UcPPXmodboVg "To create an automated breakdown, select a breakdown source for it to use and apply access restrictions. Then map which field on the indicator source references the breakdown source. Finally, assign indicators to the breakdown.")  
**Next topic:** [Assign an indicator to an automated breakdown](https://www.servicenow.com/docs/RT2ShPbtdRJywWxKwWRRFw "Associate automated or formula indicators with a breakdown to enable the collection of broken down scores for those indicators.")