Twinning: pulling Salesforce CPQ quote information into CPQ

  • Release version: Australia
  • Updated March 12, 2026
  • 2 minutes to read
    • Summarize
    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 Twinning: pulling Salesforce CPQ quote information into CPQ

    This document outlines the process for integrating Salesforce CPQ quote data into CPQ configurations in real-time, referred to as "field twinning." This integration is essential for CPQ administrators to enhance configuration, rules, and calculations based on Salesforce quote information.

    Show full answer Show less

    Prerequisites

    • Ensure the CPQ managed package in your Salesforce environment is version 0.8 or later.
    • If not upgraded, submit an Upgrade SFDC Managed Package Request ticket in the Help Center.
    • Verify the presence of a field set named ReferencedFields in the SFDC CPQ quote object (SBQQQuotec). If absent, create it.

    Implementation

    • Add a custom field to the SFDC CPQ quote object following the format <someName>LGK, resulting in an API name of <someName>LGKc.
    • Ensure that the twinned quote object in SFDC begins with a lowercase character.
    • Include the custom field in the ReferencedFields field set.
    • In CPQ, create a corresponding field with the variable name <someName>, matching the case-sensitive format of the SFDC API name without the LGK suffix.
    • Associate the CPQ field with the relevant Blueprint.

    Key Outcomes

    Upon completing the integration, when users transition from a SFDC quote to CPQ, the <someName> field in CPQ will automatically populate with the corresponding data from the SFDC quote field <someName>LGKc.

    This setup facilitates differentiated configurations for new prospects and existing customers, streamlining the quoting process and enhancing user experience within CPQ.

    You can set up Salesforce.com and CPQ to bring quote data into a CPQ configuration at runtime.

    Note:
    This article is relevant only to use cases that are integrated with Salesforce CPQ.

    On occasion, the CPQ Admin will need to bring Salesforce.com (SFDC) quote data into CPQ, to drive configuration, rules, calculations, and so on. This article describes the setup in both SFDC and CPQ that will bring relevant quote data into a CPQ configuration experience at runtime. This method of data transfer is nicknamed Twin Field or "field twinning."

    CPQ rules run differently depending on whether the account is a new prospect or an existing customer. CPQ allows new prospects to select from a subset of offers such as starter packages, whereas existing customers are limited to renewing their existing products or upgrading to higher value products.

    Prerequisites

    The CPQ managed package installed in your SFDC environment should be version 0.8 (released February 4, 2022) or later. If the managed package has not been upgraded, log an Upgrade SFDC Managed Package Request ticket in the Help Center.

    Navigation in SFDC: Setup -> Object Manager -> quote (SBQQ Quote_c) -> Field Sets.

    In the SFDC CPQ quote object (SBQQ_Quote_c), confirm that there is a field set named ReferencedFields. If no field set named ReferencedFields exists, create it. Navigation in SFDC: Setup -> Object Manager -> quote (SBQQ Quote_c) -> Field Sets.

    Implementation

    1. In SFDC, add a custom field to the SFDC CPQ quote object with the format <someName>LGK. This will create a field with the API name <someName>LGK_c.

      In Logik, variable names begin with a lowercase character by default. Take care to make sure your twinned quote object in SFDC begins with a lowercase character as well.

    2. Add this custom field to the ReferencedFields field set on the quote object. In SFDC, navigate to Setup -> Object Manager -> quote (SBQQ_Quote_c) -> Field Sets -> ReferencedFields. From the list of quote fields, drag and drop your new custom field into the In the Field Set box.

      SFDC CPQ quote object

    3. In CPQ, add a field with variable name <someName>.
      Note:
      <someName> should be the same case-sensitive string as the one defined in the SFDC API name of the corresponding field to import, <someName>LGK_c. This CPQ field should not have LGK suffix. Twinned fields can have different field types.
    4. Associate this field to the Blueprint that will utilize it.

    When a user transitions from a SFDC quote into CPQ, the new field in CPQ, <someName>, will be populated with the data that SBQQ Quote_c. <someName>LGK_c stored in SFDC.

    In Salesforce, the ReferencedFields field set is a custom field set that can be created on the Quote, Quote Line, and Quote Line Group objects. For more information, see SFDC: ReferencedFields Field Set in Salesforce CPQ.