Nested bundling in Salesforce CPQ

  • Release version: Australia
  • Updated March 12, 2026
  • 2 minutes to read
  • Enable nested bundling in Salesforce CPQ to support complex product hierarchies and configurations.

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

    Setup in Salesforce

    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.

      Setup in Salesforce

    2. On the Additional Settings tab, check the box to enable Nested Bundles for External Configurator.
    3. Click Save to save the changes.

    Products that may have other products below them in the BOM hierarchy should be marked as Logik Enabled in the Product2 record in Salesforce. This is the same as setting up configurable products to work with 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 CPQ and Salesforce CPQ:

    Nested Bundles Demo

    Setup in CPQ

    After completing the Salesforce CPQ package setting steps, log a support case to enable nested bundling in your CPQ instance.

    Note:
    Create a support case by using the ServiceNow Support portal. For step-by-step instructions, see Create a case on Now Support for CPQ (Logik.ai) Customers.

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

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