---
sourceDocument: Yokohama Strategic Portfolio Management
sourceDocumentLink: https://www.servicenow.com/docs/r/yokohama/it-business-management

 Release :

    - yokohama

ft:locale :

    - en-US

ft:publication_title :

    - Yokohama Strategic Portfolio Management

ft:clusterId :

    - itbm

bundleId :

    - itbm

workflow :

    - Technology


---

# Configure a widget for project financial metrics

# Configure a widget for project financial metrics {#ariaid-title1}

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

Configure a widget to view and track the financial metrics of a project on the
Financials tab of the Project Workspace page.
Important:  
Classic Project Workspace is being prepared for future deprecation. It will be hidden and no longer available for installation but will continue to be supported. For details, see the [Deprecation Process \[KB0867184\]](https://hi.service-now.com/kb_view.do?sysparm_article=KB0867184) article in the Now Support knowledge base. Use new Project Workspace with enhanced UI to help you efficiently manage your projects.

## Before you begin

Role required: pps_admin

## Procedure

1. Navigate to AllProject AdministrationWidgets.
2. Click New.
3. On the form, fill in the fields.  
   {#configure-widget-project-financials__table_osc_b4b_xhc__entry__2}

   | Field | Description |
   |-|-|
   | Name | Unique name for the widget. |
   | Scripted | Option for indicating the value on the widget is from a code script. By default, this option is selected and is read-only. |
   | Show Label | Option for displaying either the label or the color indicator. If you clear the check box, the Color field appears and you can set the color. |
   | Active | Option for indicating the status of the widget. Only active widgets can be shown on the Financials tab of the Project Workspace. |
   | Parent widget | Widget that is the parent of the current widget. The current widget displays in the Child widgets related list of the selected widget. You can add a maximum of three child widgets for a parent widget. |
   | Formatter required | Option for specifying whether a currency formatter is required for the widget. |
   | Script | Code script that returns a requested metric value that is displayed on the widget. In the script, use the context and filter objects. The context object contains all of the project financial fields, such as capex_costs, opex_costs, and budget_cost. The following sample script returns the Estimate At Completion metric value of a project to appear on the widget. var context = JSON.parse(context); var filter = context.filters; var now_GR = new GlideRecord('pm_project'); gr.addEncodedQuery(filter['pm_project']); gr.query(); if(gr.next()) gr.getValue('forecast_cost'); Collapse |
   | Short description | Description of the widget. |
   [Table 1. Widget form]

   {#configure-widget-project-financials__table_osc_b4b_xhc}

## What to do next

[Associate the widget to the Project table](https://www.servicenow.com/docs/UlEucg2Qwn6jGP0830c0wg "After you configure a widget, associate it with the Project table to show the financial data of a project.").
* **[Associate a widget to the Project table](https://www.servicenow.com/docs/UlEucg2Qwn6jGP0830c0wg)**   
  After you configure a widget, associate it with the Project table to show the financial data of a project.

*[\>]: and then