Skip to content
Configuring Quote Experience › Configure › price › quote apps › Configure › Sales Customer Relationship Management
Release: Australia · Updated: 2026-05-07 · Official documentation · View source

Sync Primary Quote to Opportunity

Designate a quote as primary and sync the quote's lines to the opportunity. When sync is enabled, any changes to the quote's lines are synced to the source opportunity lines. An opportunity can have only one quote marked as primary and enabled for sync.

Before you begin

Role required: admin

Before configuring the sync feature, complete the following instance setup:

  1. Activate the Quote Experience plugin (App ID: sn_quote_mgmt_adv).
  2. Submit a support ticket requesting to enable the Sync Quote to Opportunity tenant setting.
  3. When the tenant setting is enabled, export and import the transaction blueprint.

About this task

The sync feature uses the following system objects to control the sync between a primary quote and its source opportunity.

TypeDisplay nameVariable name
FieldIs Synced to Opportunitytxn.opportunity.isSynced
FieldOpportunity Line Itemtxn.line.opportunity.lineItem
EventEnable Sync to Opportunitytxn.syncToOpportunity.enable
EventDisable Sync to Opportunitytxn.syncToOpportunity.disable
IntegrationSync to Opportunitytxn.syncToOpportunity.updateStatus

To configure the feature, add a button for each sync event to the layout, configure the event properties, and optionally restrict event access by stage.

The following snapshot helps you understand the event configuration to sync the quote to opportunity.

Image omitted: cpq-event-access.png
Configuration to access events.

Procedure

  1. Add buttons to the layout

  2. Navigate to All > CPQ Administration > Transaction and open the blueprint.

  3. Select Layouts.

  4. Add a button to the layout for each sync event: Enable Sync to Opportunity and Disable Sync to Opportunity.

  5. Configure the Enable Sync to Opportunity event

  6. Open the properties for the Enable Sync to Opportunity event.

  7. Add the Sync to Opportunity integration (txn.syncToOpportunity.updateStatus) to the event.

  8. Set the Event Access for the event.

  9. Configure the Disable Sync to Opportunity event

  10. Open the properties for the Disable Sync to Opportunity event.

  11. Add the Sync to Opportunity integration (txn.syncToOpportunity.updateStatus) to the event.

  12. Set the Event Access for the event.

  13. (Optional) Restrict event access by stage

  14. In Views, adjust the access to the sync events for each stage.

    This configuration lets you set the sync events to No Access on specific stages.

Result

When a user selects Enable Sync to Opportunity, the quote's lines sync to the source opportunity lines, and subsequent changes to the quote's lines continue to sync. When a user selects Disable Sync to Opportunity, the sync stops.