---
sourceDocument: Australia Sales Customer Relationship Management
sourceDocumentLink: https://www.servicenow.com/docs/r/australia/order-management

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia Sales Customer Relationship Management

ft:clusterId :

    - omgmt

bundleId :

    - omgmt

workflow :

    - Customer and Industry


---

# Integrating kBridge visualization

# Integrating kBridge visualization {#ariaid-title1}

Release version: Australia  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read
Summarize  
![AI sparkle icon](https://servicenow.com/docs/portal-asset/ai-sparkle-icon) Summarized using AI  
This content was generated using new OpenAI-powered functionality. Results are provided on an as is basis and are not guaranteed to be accurate or complete.  

## Summary of Integrating kBridge visualization

ServiceNow CPQ supports integration with kBridge to enable real-time 3D visualization during the product configuration process.
This integration enhances the user experience by synchronizing configuration inputs with visual updates within the ServiceNow CPQ user interface.
Show full answer Show less  
The integration supports one-way communication, where changes in configuration inputs update the kBridge visualization, and optionally two-way communication, where user manipulations in the 3D graphic update the ServiceNow CPQ configuration fields.

## Integration Setup

The kBridge visualization component is configured within the ServiceNow CPQ blueprint layout definition. This layout defines:

* Where the kBridge visualization component appears in the UI.
* The kBridge connection details (script URL, app URL, authentication token).
* The mapping of ServiceNow CPQ fields, sets, and product pickers to kBridge events.

To implement the component, the layout CSV file includes a row specifying the kBridge component type and JSON configuration parameters in the value column.

## Key Configuration Parameters

* **scriptUrl** , **appUrl** , **token**: URLs and authentication token for connecting to kBridge.
* **sessionStartup**: Startup information for initializing the kBridge session, configured with the help of kBridge administrators.
* **eventFields** , **eventSets** , **eventProductPickers**: Mappings that define which ServiceNow CPQ fields, sets, and product pickers trigger updates in kBridge.
* **setActiveTriggers**: Defines specific triggers for active sets within ServiceNow CPQ.
* **listenerFields**: For two-way communication, specifies which ServiceNow CPQ text field will receive JSON data from user interactions in kBridge. Administrators must define rules to parse this data and update CPQ fields accordingly.
* **height** and **width**: Size of the kBridge visualization component within the layout, specified in pixels.

## Communication Behavior

If `listenerFields` are not defined, all event fields support two-way communication. When `listenerFields` are included, event fields communicate only from ServiceNow CPQ to kBridge, while event sets and product pickers always send data one-way to kBridge.

## Practical Benefits for ServiceNow Customers

* Real-time 3D visualization enables end users to see configuration changes reflected instantly, improving accuracy and engagement.
* Two-way synchronization allows updates made via the 3D interface to directly affect configuration inputs, streamlining the configuration process.
* Flexible layout and configuration options allow tailoring the visualization experience to specific business needs and UI designs.

## Next Steps

To implement kBridge integration, customers should work with their kBridge administrators or implementers to obtain the necessary connection details and session startup parameters. Then, define the blueprint layout CSV to include the kBridge component and configure the mappings and triggers as needed. Setting up appropriate parsing rules for listener fields is essential for enabling two-way data synchronization.  
Integrate kBridge for real-time 3D visualization. Sync configuration inputs with visual updates to enhance user experience.
ServiceNow CPQ supports several different 3D visualization options in the end-user configuration experience. ServiceNow CPQ can be implemented to use kBridge as a visualization component that is updated in real time in the ServiceNow CPQ UI as the user changes configuration inputs (one-way communication). In addition, bidirectional (two-way) communication may be defined so that user manipulations of the graphic update ServiceNow CPQ configuration fields.

The following video shows how to integrate ServiceNow CPQ with kBridge for real-time updates:

[KBridge Integration Setup Demo](https://www.youtube.com/watch?v=X4sxdRtz_v4)

The integration between ServiceNow CPQ and kBridge is set up in the ServiceNow CPQ blueprint layout definition. The layout definition:

* defines where the kBridge visualization component will be rendered on the ServiceNow CPQ UI
* specifies the kBridge connection
* identifies the ServiceNow CPQ field or set data to be sent

{#cpq-kbridge-visualization-integration__ul_lqx_ssf_rgc}

To create a kBridge component, the `kbridge` layout component type can be added in the "type" column of the layout CSV file. Additional properties for the integration are set in the "value" column.

This sample layout CSV file demonstrates the use of the kBridge component and parameter inputs. See row 12.

[kBridge_setsv2-layoutCSV](https://docs.google.com/spreadsheets/d/1AqYC6enIGexuzgEC8e89GsVtd6lnRhUje0BiTkt2Uzs/edit?usp=sharing)

## JSON value template {#cpq-kbridge-visualization-integration__section_i4t_f3h_whc}

    scriptUrl: string,
    appUrl: string,
    token: string,
    sessionStartup: object
    eventFields: object
    eventSets: object
    eventProductPickers: object
    setActiveTriggers: array
    listenerFields: object
    height: number
    width: number

## kBridge connection {#cpq-kbridge-visualization-integration__section_mbl_33h_whc}

* scriptUrl: URL for kBridge script
* appUrl: URL for kBridge app
* token: Auth token from kBridge
* sessionStartup: Additional kBridge startup information; work with kBridge, your implementer or kBridge administrator to determine the appropriate values to pass in this parameter for your kBridge setup
{#cpq-kbridge-visualization-integration__ul_hyd_45f_rgc}

## ServiceNow CPQ data {#cpq-kbridge-visualization-integration__section_amn_j3h_whc}

* `eventFields`: Mapping of ServiceNow CPQ fields to kBridge
* `eventSets`: Mapping of ServiceNow CPQ sets to kBridge
* `eventProductPickers`: Mapping of ServiceNow CPQ product pickers to kBridge
* `setActiveTriggers`: ServiceNow CPQ set triggers
* `listenerFields`: For two-way data communication involving one or more ServiceNow CPQ sets, this object specifies the ServiceNow CPQ text field variable name to which a JSON representation of the set(s), manipulated in the kBridge visualization by the user, will be returned to ServiceNow CPQ. The Admin must define a rule that parses the content of the listenerFields and populates the appropriate set inputs.  
  Note:  
  * If a blueprint/layout has `eventFields` but not `listenerFields`, every event field has two-way communication.
  * If a listener field is added to the blueprint or layout, all event fields will communicate only from ServiceNow CPQ to kBridge.
  * Event sets and event product pickers pass information only from ServiceNow CPQ to kBridge, and not from kBridge to ServiceNow CPQ.
  * From a data standpoint, event sets and event product pickers data are passed the same way to kBridge (in an array of objects).
  {#cpq-kbridge-visualization-integration__ul_owr_y5f_rgc}
{#cpq-kbridge-visualization-integration__ul_dpc_t5f_rgc}

## Layout size {#cpq-kbridge-visualization-integration__section_gsb_l3h_whc}

* `height`: element height in layout, value is in pixels
* `width`: element width in layout, value is in pixels
{#cpq-kbridge-visualization-integration__ul_rrh_h5f_rgc}

## Example JSON values {#cpq-kbridge-visualization-integration__section_cyz_m3h_whc}

    {
      scriptUrl: 'http://script.location';,
      appUrl: 'http://app.script.location';,
      token: 'abc-123-def-456',
      sessionStartup: {
        type: 'model',
        revisionId: '1234-5678-90'
      },
      eventFields: {
        field1: { name: 'field-1', refChain: 'world.application.model' },
        field2: { name: 'field-2', refChain: 'world.application.model' },
        field3: { name: 'field-3', refChain: 'world.application.model' }
      },
      eventSets: {
        set1: { name: 'set-1', refChain: 'world.application.model' },
      },
      eventProductPickers: {
        picker1: { name: 'picker-1', refChain: 'world.application.model' },
      },
      setActiveTriggers: ['set.set2.triggerBoolean'],
      listenerFields: { 
        listenerFieldName: { name: 'ServiceNow CPQTestSet', refChain: 'world.application.model' }
      },
      height: 800,
      width: 1200,
    }

* `name` corresponds to the field or rule name in kBridge.
* `refChain` corresponds to the model path of this object in kBridge.
{#cpq-kbridge-visualization-integration__ul_ffl_xtf_rgc}

## Reference {#cpq-kbridge-visualization-integration__section_wyh_q3h_whc}

For a discussion of features available among supported visualization applications in integration with ServiceNow CPQ, see [Visualization Integrations: An Overview](https://logikio.atlassian.net/wiki/spaces/CS/pages/1615462425/Visualization+Integrations+An+Overview).