---
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


---

# Nested bundling in Salesforce CPQ

# Nested bundling in Salesforce CPQ {#ariaid-title1}

Release version: Brazil  
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 Nested bundling in Salesforce CPQ

Nested bundling in Salesforce CPQ enables handling complex product hierarchies and configurations by supporting nested bundle structures between ServiceNow CPQ and Salesforce CPQ.
This feature allows customers to leverage the Bill of Materials (BOM) hierarchy defined in ServiceNow CPQ and have it accurately reflected in the Salesforce CPQ Quote Line Editor (QLE).
Show full answer Show less  

## Setup in Salesforce CPQ

To enable nested bundling:

* Ensure you are using Salesforce CPQ package version 242 (Spring 2023) or later.
* Go to Setup \> Installed Packages \> Salesforce CPQ and click Configure.
* On the Additional Settings tab, enable the checkbox for **Nested Bundles for External Configurator** and save changes.
* Mark products that can have nested components by setting them as **ServiceNow CPQ Enabled** in the Product2 record.
* Ensure these products have pricebook entries in the pricebook used for quotes to be created as quote lines.

## Setup in ServiceNow CPQ

After configuring Salesforce CPQ, submit a support case through the ServiceNow Support portal to enable nested bundling in your ServiceNow CPQ instance. It is recommended to test this functionality in a development or test environment before deploying it to production.

The BOM hierarchy in ServiceNow CPQ is defined using **parentProduct** and **uniqueIdentifier** fields on bill of materials items, which is then reflected in the Salesforce CPQ quote line editor.

## Limitations

* Nested bundles are limited to four levels, including the top-level parent product, allowing up to three levels of nested products inside ServiceNow CPQ configurations.
* A known error occurs if the same product is added to two dynamic nested bundles via an external configurator in Salesforce CPQ, causing an "Attempt to de-reference a null object" error. This happens if a product is nested inside multiple dynamic features under the same parent.  
Enable nested bundling in Salesforce CPQ to support complex product hierarchies and configurations.

With some additional configuration, ServiceNow CPQ now supports sending back a nested bundle structure from ServiceNow CPQ to Salesforce CPQ. This allows you to take advantage of the BOM hierarchy built in ServiceNow CPQ and have it reflected in the Salesforce CPQ Quote Line Editor (QLE).

## Setup in Salesforce {#cpq-nested-bundling-in-salesforce-cpq__section_y5x_tzt_rgc}

To enable support for nested bundles, additional setup steps must be completed in the Salesforce CPQ Package settings. These steps require Salesforce CPQ package version 242 (Spring 2023) or later.  
1. Navigate to Setup \> Installed Packages \> Salesforce CPQ, and then click Configure.

2. On the Additional Settings tab, check the box to enable Nested Bundles for External Configurator.
3. Click Save to save the changes.
{#cpq-nested-bundling-in-salesforce-cpq__ol_crt_l15_rgc}

Products that may have other products below them in the BOM hierarchy should be marked as ServiceNow CPQ Enabled in the Product2 record in Salesforce. This is the same as setting up configurable products to work with ServiceNow CPQ. The products also need to have a pricebook entry in the pricebook used for the quote if they are going to be created as quote lines.

The following video explains setting up nested bundle structures in ServiceNow CPQ and Salesforce CPQ:

[Nested Bundles Demo](https://www.youtube.com/watch?v=3EBOPNW_Gds)

## Setup in ServiceNow CPQ {#cpq-nested-bundling-in-salesforce-cpq__section_xzn_5zt_rgc}

After completing the Salesforce CPQ package setting steps, log a support case to enable nested bundling in your ServiceNow CPQ instance.  
Note:  
Create a support case by using the [ServiceNow Support portal](https://support.servicenow.com). For step-by-step instructions, see [Create a case on Now Support for CPQ Customers](https://support.servicenow.com/kb?sys_kb_id=d67d3e71475d7a90f64de825126d4326&id=kb_article_view).

As with any larger change, the recommendation would be to start in a dev or test environment and validate that it is working as expected before enabling it in production.

In ServiceNow CPQ, the BOM hierarchy is defined through the parentProduct and uniqueIdentifier fields on items in the bill of materials. This hierarchy in the product list is reflected in the Salesforce CPQ quote line
editor.

## Limitations {#cpq-nested-bundling-in-salesforce-cpq__section_yqp_kb5_rgc}

Nested bundles from external configurators are limited to four levels, including the topmost parent. This means you can nest products up to three levels deep inside a ServiceNow CPQ configuration.  
Note:  
Trying to add the same product to two dynamic nested bundles via an external configurator in Salesforce CPQ results in an "Attempt to de-reference a null object" error.

For example, suppose Product X is nested inside both the
Nested Child 1 dynamic feature and the Nested Child 2 dynamic feature, when both are children of the Parent dynamic feature. This configuration results in the error.

