Welcome to Zuora Product Documentation

Explore our rich library of product information

CPQ

Presents release notes and resolved issues for Zuora CPQ in 2025.Q4 product release.

Zuora release 2025.Q4 corresponds with Quotes 10.50.

Note:

In Quotes version 10.50, a new field set named zqu__Original_QRPC (Original QRPC) has been introduced under the Quote Rate Plan Charge object. If your Extensibility Framework code references the charge.originalQRPC property from quoteState, review your implementation to ensure that all required fields used in your code are included in the zqu__Original_QRPC field set. Previously, the originalQRPC property was a direct copy of the charge.record property within quoteState.

New and changed features

FeatureDescriptionUpdated

CPQ X

The following button behavior is refined:

  • The Keep Quote and Leave without Saving Change button remains visible even when the rules engine errors occur, allowing you to navigate back safely.

  • The Save changes and Leave button stays hidden when rules engine error occurs.

10.50

CPQ X

As Salesforce has announced the end of support for Workflow Rules by the end of 2025, we are transitioning our package Workflows to Salesforce Flows to ensure continued compatibility and support.

Our package previously included two Workflow Rules:

  • ZQSubTermTypeAction – previously Active

  • ZQSubTermTypeDefaultAction – previously Inactive

With this release:

  • Both Workflow Rules are now set to Inactive.

  • They have been migrated to Flows with the same names and corresponding statuses.

Note:

You must deactivate the ZQSubTermTypeAction and ZQSubTermTypeDefaultAction workflow rules, if they are active, before upgrading to Quotes version 10.50 or later.

If you previously modified the activation status of either Workflow Rule from its default, we recommend that you set the corresponding Flow to the same status to maintain consistent behavior.

Updated: November 27, 2025

10.50

CPQ X

A new setting, Enforce Single MSQ Primary Quote per Opportunity, has been added for Multi Subscription Quoting (MSQ) under Admin Config.

When enabled, only one MSQ primary quote can exist per opportunity — marking a new MSQ parent quote as primary automatically unchecks the others. You can no longer use the Primary field on child MSQ quotes.

This setting also works in conjunction with the existing Single Subscription Quoting (SSQ) setting, Enforce Single Primary Quote, under Quote Configuration Settings.

When both settings are enabled, only one primary quote — either an MSQ or an SSQ — can exist within the same Opportunity. If a non-primary quote is sent to Zuora Billing, it will now be automatically marked as primary.

Previously, primary quote enforcement was not supported for MSQ parent quotes, allowing you to create multiple primary MSQ parent quotes under the same Opportunity.

For more information, see Quote Studio admin settings configuration.

10.50

CPQ X

Quote Studio now supports creating Quick Filters based on specific Permission Sets, similar to how Quick Filters can be defined for specific Profiles.

With this enhancement:

  • If a Permission Set is selected for a Quick Filter, only users assigned to that Permission Set can access the filter in the Browse Product window.

  • If both Profiles and Permission Sets are selected for a Quick Filter, it is accessible to users assigned to any of the selected Profiles or Permission Sets.

  • If no specific Profile or Permission Set is selected, the Quick Filter is available to all end users.

New field introduced: List_Filter__c.PermissionSet_Visibility_List__c

Permission updates:

  • Zuora Quotes End User Permission Set: Editable = False, Readable = True

  • Zuora Quotes Product Admin Permission Set: Editable = True, Readable = True

10.50

CPQ X

You can now delete newly added rows in the Negotiated Pricing table that exist only within Salesforce and have not yet been sent to Zuora. Rows defined in the Zuora Commerce Catalog cannot be deleted to maintain catalog data integrity and consistency.

10.50

CPQ X

Enhances the Quote Studio layout by aligning the Prepaid Balance section with other sections for a consistent behavior.

10.50

CPQ X

We have enhanced the key usability of the Rate Card table in Quote Studio, helping Salesforce users navigate and interpret rate data more efficiently.

  • Fixed the table header during scroll

    The Rate Card table header (attribute names and operators) now remains fixed while users scroll through table rows. This ensures that attribute names and operators stay visible when reviewing large pricing tables.

  • Operator legend with tooltip

    A legend (key) is added to help Salesforce users quickly understand the meaning of operators in the Rate Card table.

    Example:

    "==" → Strictly Equal

    ">=" → Greater Than or Equal To

    "<=" → Less Than or Equal To

    The legend is accessible via a hover-over tooltip on the Rate Card header or operator column.

10.50

CPQ X

The scroll bars in the Quote Studio UI have been resized for a more consistent user experience.

10.50

CPQ X

For SSQ, we have introduced the afterQuoteStudioLoad hook and collapseproduct event in the extensibility framework. This hook executes immediately after Quote Studio loads. For more information, see Headless component - hooks.

You can use the event to collapse Product Timelines in the Quote Studio UI components. For more information, see Headless component - events.

10.50

CPQ X

You can now programmatically remove toast messages dispatched from Extensibility Framework components using two new parameters:

  • remove – optional. Indicates that the toast message should be removed.

  • id – optional. Stores the unique identifier of the toast message to be dispatched and later removed. Use the same ID to remove the toast message.

All toast messages now correctly respect their configured timeout settings. Previously, the timeout parameter was not applied to error-themed toast messages. For more information, see Headless and sidebar component - events.

10.50

CPQ X

The pop-up size has been fixed to display correctly when Multi-Org is disabled.

10.50

CPQ X

To prevent conflict, the Save and Submit buttons are disabled when the custom components from the sidebar are open.

10.50

CPQ X

Added new feature options in Zuora Config > Quote Studio Settings > Restricted Access Config.

  • Hide Browse Product Modal - when this feature is enabled and configured, the Browse Product option in the subscription information section is hidden for selected profiles.

  • Hide Quick Add Product Search Bar - when this feature is enabled, the Search Products and Rate Plans search bar in the subscription information section is hidden for selected profiles.

  • Delete Product Button - when this feature is enabled, the Delete option in the rate plan charge table is hidden for selected profiles.

10.50

CPQ X

The package major and minor version details are now retrieved from the system instead of the custom setting, ensuring accurate version information. Previously, these details were retrieved from the Zuora Config custom setting; however, in some cases, the values were not being populated correctly.

10.50

CPQ X

Added new custom labels to customize the text on the Quote Start Date selection page.

  • QSD_AlignAndEliminateFutureActions - Would you like to align all Initial Actions of a RatePlan timeline to QSD and eliminate all future dated actions?

  • QSD_AlignAndKeepFutureUnchanged_Ramp - Would you like to align all Initial Actions of a RatePlan timeline to QSD and keep all future dated actions unchanged?

  • QSD_AlignInitialAndFutureActions - Would you like to align all Initial Actions of a RatePlan timeline to QSD and keep all future dated actions respectively aligned?

  • QSD_KeepInitialActionsAsIs - Would you like the Initial Actions of a RatePlan timeline to remain as is?

With this enhancement, administrators can use custom labels to tailor or localize text for specific business terminology.

10.50

CPQ X

Added a new public method ProductTimeline.getRemovedCharges to fetch charges from the latest or previous version based on the RemoveProduct state. This method validates the timeline structure and amendment type, returning an empty array for invalid inputs. For more information, seeJS global class.

10.50

CPQ X

We have introduced a new Domain-Specific Language (DSL) system for use in the CRM Mapping field of the attribute definition.

With this enhancement, you can now configure mappings between Zuora Object fields and Salesforce Object fields to populate values in new subscription quotes.

The mapped attribute value is also auto-populated in the Rate Card (in read-only mode) for any Dynamic Pricing configurations that reference the related CPQ Object field.

10.50

CPQ X

As part of the save performance optimization, a new field set named zqu__Original_QRPC (Original QRPC) has been introduced under the Quote Rate Plan Charge object.

With this enhancement, only the fields defined in the field set zqu__Original_QRPC (Original QRPC) are now loaded into the originalQRPC property within each charge under quoteState.

The following fields are added to the zqu__Original_QRPC field set.

  • zqu__BillingPeriodAlignment_c

  • zqu_Quantity__c

  • zqu__EffectivePrice__c

Previously, all fields from the Quote Rate Plan Charge object were being loaded, which could impact performance.

If your Extensibility Framework code references the ​charge.originalQRPC​ property from quoteState, review your implementation to ensure that all required fields used in your code are included in the ​zqu__Original_QRPC​ field set. Previously, the originalQRPC property was a direct copy of the charge.record property within quoteState.

10.50

CPQ X

From Quotes version 10.50:

  • Parent Id field is populated for info-type log records.

  • For info-type log records where the method name is QuoteStudioController.saveQuoteDetails, the Details field now logs the quoteStateJson instead of the parentQuoteJson.

  • For the savePreviewMetrics and saveQuoteDetails method, if the content exceeds the 131k character limit in the Details field, the text is truncated and appended with ellipses.

10.50

CPQ X

As part of ongoing save operation optimization, several classes and methods within the Quote Studio save flow have been refined to improve overall performance.

10.50

CPQ X

A new custom label, NEW_MULTI_SUB_QUOTE_LABEL, has been introduced to allow customization of the New Multi Sub Quote button text on the Subscription Selector page in Quote Studio.

This enhancement provides greater flexibility to define any desired value for the button label.

10.50

CPQ 2025.Q4 fixes

For the list of resolved issues, see CPQ 2025.Q4 fixed issues in the Support Center. Additional logon information may be required to access the Zendesk portal.