---
sourceDocument: Brazil Sales Customer Relationship Management
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/order-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Sales Customer Relationship Management

ft:clusterId :

    - omgmt

bundleId :

    - omgmt

workflow :

    - Customer and Industry


---

# Integrating ServiceNow CPQ with visualization tools

# Integrating ServiceNow CPQ with visualization tools {#ariaid-title1}

Release version: Brazil  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 3 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 ServiceNow CPQ with visualization tools

ServiceNow CPQ enables integration with third-party visualization engines---CDS, kBridge, and Threekit---to render dynamic 2D and 3D product visuals that update in real time as users configure product options, colors, dimensions, and bundles.
This integration enhances the user experience by synchronizing visual states with UI inputs and optionally supports two-way data exchange where user actions in the visualization can update configuration fields within ServiceNow CPQ.
Show full answer Show less  

## Supported Visualization Vendors and Capabilities

* **CDS:** Supports both one-way and two-way communication. Can send and receive fields, sets (up to 25 rows), product pickers (up to 25 options), and active set indices. Suitable for CAD/2D/3D visuals with flexible object mapping.
* **kBridge:** Supports one-way and two-way communication with real-time 3D rendering and a rich event/listener model. Handles fields, sets, product pickers, and active set indices similarly to CDS.
* **Threekit:** Supports only one-way communication. Sends fields, asset IDs, and active set indices to display high-fidelity visuals but does not support data write-back from the viewer.

Note: When sending sets or product pickers, only the first 25 rows or options are transmitted. The Active Set Index can be used to keep the visualization in sync with the row currently being edited.

## Integration Architecture and Data Flow

* **Layout Component:** Defines the visualization panel's position and size within the configuration blueprint.
* **Connection Settings:** Include URLs, authentication tokens, and subdomains to authorize and route communication between ServiceNow CPQ and visualization tools.
* **Mapping Block:** Specifies which ServiceNow CPQ data to send, including field variables, sets (up to 25 rows), product pickers (up to 25 options), and active set index triggers for set repeaters.
* **Listener Field:** A ServiceNow CPQ text field configured to receive JSON data from the visualization viewer, parsed by determination rules or enrichments to update configuration fields or set rows (only for two-way supported vendors).

## Security and Environment Considerations

* Use appropriate vendor tokens and URLs for production and non-production environments.
* Ensure ServiceNow CPQ Runtime Client origins match calling domains.
* Configure Content Security Policy (CSP) to allow embedding and messaging with vendor script or app hosts, coordinating with security teams.
* Keep vendor credentials separate across environments and update tokens when promoting changes.

## Choosing the Right Visualization Tool

* For bidirectional editing capabilities, select **kBridge** or **CDS** with listener fields and parsing rules implemented.
* For high-fidelity 3D visuals and asset management with one-way updates, use **Threekit** leveraging assetId strategies.
* For set-driven user experiences requiring two-way JSON handling and active set synchronization, prefer **CDS** or **kBridge**.

## Best Practices

* Map only essential data fields, sets, and product pickers to optimize performance.
* Design around the 25-item cap for sets and product pickers by implementing validation, paging, or summarization.
* Create a stable JSON schema for two-way listener payloads and centralize parsing logic in managed rules or enrichments.
* Externalize environment-specific values (tokens, URLs) to enable safe promotion across environments.
* Troubleshoot using admin logs, CSP/network access verification, browser devtools, and ServiceNow CPQ debugger inputs.  
Learn how ServiceNow CPQ connects to third-party visualization engines---CDS, kBridge, and Threekit---to render 2D/3D product views that respond to configuration inputs in real time.  
You can perform the following:

* Show live visuals as users configure: colors, dimensions, options, and bundles can update the viewer instantly.
* Coordinate UI + visual states: publish field values, set rows, and selected products to the renderer.
* (Optional) Write back from the viewer: for supported vendors, user actions in the canvas can update fields.
{#logik-io-integration-wtih-visualization-tools__ul_g22_3yz_ghc}

## Supported vendors at a glance {#logik-io-integration-wtih-visualization-tools__section_ssm_kyz_ghc}

{#logik-io-integration-wtih-visualization-tools__table_grp_myz_ghc__entry__5}

| Vendor | Direction | What you can send | What can be written back | Notes |
|-|-|-|-|-|
| CDS | 1-way and 2-way | Fields, Sets (first 25 rows), product pickers (first 25 options), Active Set Index | Fields; Sets via listener field JSON + rule parsing | Good for CAD/2D/3D; flexible mapping objects |
| kBridge | 1-way and 2-way | Fields, Sets (first 25 rows), product pickers (first 25 options), Active Set Index | Fields; Sets via listener field JSON + rule parsing | Real-time 3D with rich event \& listener model |
| Threekit | 1-way | Fields, Asset Id (static or via field), Active Set Index (visual focus only) | Not supported (viewer → ServiceNow CPQ) | Use for high-fidelity visuals; map fields and asset selection |
[Table 1. List of vendors]

{#logik-io-integration-wtih-visualization-tools__table_grp_myz_ghc}  
Note:  
When sending sets or product pickers, ServiceNow CPQ publishes up to 25 rows/options. Indices and options beyond 25 are not transmitted. When using set repeaters, you can publish an Active Set Index trigger so the viewer shows the row the user is editing.

## How the integration works {#logik-io-integration-wtih-visualization-tools__section_cxs_zg1_hhc}

1. The layout component in the blueprint defines the visualization panel's position and size.
2. Connection settings authorize and route traffic (for example, the script or app URL, the auth token, and the subdomain).
3. The mapping block selects what ServiceNow CPQ data to send:
   * `eventFields` --- field variable names and their viewer keys
   * `eventSets` --- set variable names (first 25 rows published as an array of objects)
   * `eventProductPickers` --- selected options (first 25) as an array of objects
   * `setActiveTriggers` --- Boolean fields that indicate the active index in a set repeater
   {#logik-io-integration-wtih-visualization-tools__ul_tmr_1h1_hhc}
4. (Two-way only) A listener field (ServiceNow CPQ text field) receives JSON from the viewer.
   * Add a determination rule (or enrichment) to parse that JSON and update fields or set rows.
   * If a listener field is present, only mappings explicitly configured for two-way will write back.
{#logik-io-integration-wtih-visualization-tools__ul_umr_1h1_hhc}  
{#logik-io-integration-wtih-visualization-tools__table_cpq_integration_matrix__entry__3}{#logik-io-integration-wtih-visualization-tools__table_cpq_integration_matrix__entry__9}

| Viz vendor | 1-way communication |||| 2-way communication ||
| Viz vendor | Field | Set | Set repeater: active index | Product picker | Field | Set |
|-|-|-|-|-|-|-|
| CDS | Supported | Supported | Supported | Supported | Supported | Supported through implementation. See vendor-specific implementation article. |
| kBridge | Supported | Supported | Supported | Supported | Supported | Supported through implementation. See vendor-specific implementation article. |
| Threekit | Supported | Not supported | Supported | Not supported | Not supported | Not supported |
[Table 2. Visualization tool feature support]

{#logik-io-integration-wtih-visualization-tools__table_cpq_integration_matrix}

## Data exchanged {#logik-io-integration-wtih-visualization-tools__section_a12_wh1_hhc}

* Fields: Scalar values (text, number, Boolean, picklist selection).
* Sets: Array of row objects (first 25). Use the Active Set Index to keep the visual in sync with the row being edited in a repeater.
* Product pickers: Array of selected option objects (first 25).
* Assets (Threekit): Provide a static `assetId` or an asset-ID field in ServiceNow CPQ to enable dynamic asset selection.
{#logik-io-integration-wtih-visualization-tools__ul_sh5_wh1_hhc}

## Security and environments {#logik-io-integration-wtih-visualization-tools__section_h2j_b31_hhc}

* Auth and origin: Use vendor tokens and URLs appropriate to prod vs non-prod. Ensure your ServiceNow CPQ Runtime Client origins match calling domains.
* CSP (Content Security Policy): Allow vendor script or app hosts for embedding and messaging. Coordinate with your security team and ServiceNow CPQ support to add domains.
* Separation of concerns: Keep vendor credentials and tokens out of shared layouts across environments. Swap tokens when promoting.
{#logik-io-integration-wtih-visualization-tools__ul_lvt_b31_hhc}

## When to choose which tool {#logik-io-integration-wtih-visualization-tools__section_tf5_c31_hhc}

* If you need bidirectional edits in the canvas, choose kBridge or CDS and implement a listener field and parsing rules.
* If you need high-fidelity 3D with asset management and one-way updates, choose Threekit with an assetId or assetId field strategy.
* If you have a heavy set-driven UX, prefer CDS or kBridge for two-way set JSON handling and Active Set Index synchronization.

## General guidelines {#logik-io-integration-wtih-visualization-tools__section_vq4_f31_hhc}

* Map only what you need: Limit `eventFields`, `eventSets`, and `eventProductPickers` to essential data for performance.
* Design for the 25-item cap: If users may exceed 25 set rows or product picker selections, add guardrails (such as validation, paging, or summarization).
* Normalize for two-way: Define a stable JSON schema for listener payloads and centralize parsing logic in a managed rule or enrichment.
* Promote safely: Externalize environment-specific values such as tokens and URLs. Verify visuals in test before production promotion.
* Troubleshoot systematically:
  * Check admin logs for runtime or script errors.
  * Verify CSP and network access to vendor domains.
  * Use the viewer's console/devtools and ServiceNow CPQ debugger inputs to reproduce states.
  {#logik-io-integration-wtih-visualization-tools__ul_tj4_g31_hhc}
**Related concepts**   

* [Integrating kBridge visualization](https://servicenow-prod.fluidtopics.net/SSoLGi24SRddQXqNw6tshw "Integrate kBridge for real-time 3D visualization. Sync configuration inputs with visual updates to enhance user experience.")
* [Integrating CDS or other third-party visualization tools](https://servicenow-prod.fluidtopics.net/aSCs1DZYxW~dn0UwPQbkJg "Integrate CDS Visual or other third-party tools for technical visualization. Sync configuration inputs with visual updates to enhance user experience.")
* [Integrating Threekit visualization](https://servicenow-prod.fluidtopics.net/oTWyA2Q4Dt4C1167OFMBqQ "Integrate Threekit for visualization. Sync configuration inputs with visual updates to enhance user experience.")

