Welcome to Zuora Product Documentation

Explore our rich library of product information

Platform

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

New and changed features

FeatureDescriptionUpdated

Data_Loader

We have added the Data Dictionary for Update amendments.

2025.Q4.1.0

Data_Loader

Field Mapping now shows all required fields by default, providing you with immediate visibility into mandatory mappings.

2025.Q4.1.0

Mediation

The Events page has been enhanced with new visual representations that display key metrics in addition to the existing tabular data. You can also download the dataset for further analysis.

2025.Q4.1.0

Mediation

HTTP Processor Enhancements:

Improved Reliability: Added a 'Pass on event' in case of error option, allowing meters to continue processing even if upstream HTTP calls fail.

Stronger Validation: Enforced tighter checks for retry and timeout settings.

2025.Q4.1.0

Mediation

New APIs:

A new asynchronous API is now available to download and manage Audit Trail data. The API supports advanced filtering by time range, run status, run type, export type, session IDs, and operator IDs, allowing precise and efficient data retrieval. You can export results as a pre-signed CSV file containing up to 5 million records, enabling large-scale audit data analysis for compliance and reporting.

A new API has been introduced to retrieve aggregated summary data for a specified meter. It supports grouping by Processor Id, Error Code, or Session Id, and allows optional filters such as Query From Time, Query To Time, Operator Ids, and Session Ids. The API returns aggregated output and error counts per group and includes validation with detailed error responses for invalid parameters or formats.

Note: The Summary API /meters/{meter_id}/summary can show negative counts and blank sessionId entries for certain legacy sessions. This issue has been fixed with this release. However, historical data will not be retroactively corrected. For legacy sessions, use overall summaries or avoid grouping by sessionId if you observe negative counts or blank sessionId entries.

2025.Q4.1.0

Mediation

Meter run export functionality has been enhanced to enable downloading both successful and error records that exceed the standard limit. The records are downloaded through a batch job. For smaller datasets, you can continue using the existing download method. This enhancement removes previous restrictions on large-scale record downloads.

The UI now provides options to export All records, Success only, or Errors only, and will trigger an export job when counts exceed the synchronous download limit.

2025.Q4.1.0

Workflow

You can now configure custom email headers in the new Custom Headers tab of the Email notification task.

2025.Q4.1.0

Workflow

Email and Callout notification tasks now support including the related Object ID in customer notification history. This enhancement enables you to specify the ID of the object associated with each notification.

2025.Q4.1.0

Zuora SDK

We have released the following version for each of the Zuora client libraries:

  • Java: 3.12.0

  • Node.js: 3.12.0

  • Python: 3.12.0

  • C#: 1.4.0

See Changelog for Zuora client libraries.

2025.Q4.0.0

Added: November 13, 2025

Deployment Manager

Deployment Manager now supports the API versioning feature, allowing customers to set a default API version for all API requests to their tenant. This option is available under Admin Settings.

2025.Q4.0.1

Added: November 5, 2025

Deployment Manager

Deployment Manager now supports Context, Attributes, and Dynamic Pricing deployments. For successful deployment, deploy Context and Attributes before deploying Product, Product Rate Plans, and Product Rate Plan Charges. For more information, see Deploy context and attribute.

2025.Q4.0.1

Added: November 13, 2025

Data Source Exports

To enhance security and align with the Zuora UI, values that start with =, +, -, @, or ; are now prefixed with an apostrophe (') when exporting data through the Data Source Exports or AQuA API operations.

This enhancement prevents unintended formula execution and mitigates CSV injection vulnerabilities.

2025.Q4.0.0

Added: November 20, 2025

Custom Logic

Platform administrators are now granted the following custom logic permissions by default:

  • View Logic

  • Manage Logic

This enhancement ensures that tenant users with the Platform Administrator user role can immediately access and manage Custom Logic data without additional configurations.

See Custom Logic overview.

2025.Q4.0.0

Added: October 28, 2025

Audit Trail

We have enhanced the Audit Trail feature to support auditing API versioning setting changes.

Any changes to the API Versioning setting are now recorded in the auditsettingchangeevent table, allowing administrators to audit these changes with ease.

Custom Logic

Audit trail now records object change events triggered by custom logic. This enhancement improves data compliance and monitoring for field updates triggered by the Custom Logic feature.

See Custom Logic and Audit Trail.

Data Loader

We have added a clone icon that allows you to quickly clone existing Job Definitions.

Data Loader

Data Loader now supports standardized export queries compatible with the import template. The queries are accessible within the user interface at Data Query > Templates > Data Loader Exports.

Data Query

Data Loader now supports standardized export queries compatible with the import template. The queries are accessible within the user interface at Data Query > Templates > Data Loader Exports.

Deployment Manager

Deployment Manager now supports migrating Decision Trees and Decision Tables between environments.

Added: October 24, 2025

Deployment Manager

Deployment Manager now displays the following configuration categories under the Extension Studio section, while the functional flow remains unchanged:

  • Context and Attributes
  • Custom Logic
  • Custom Objects
  • Events and Notifications
  • Workflows

Added October 31, 2025

Events and Notifications

Email templates now support conditional logic and loop control, allowing you to build dynamic tables and control the visibility of content based on advanced merge field expressions.

See Logic control and looping and Merge field syntax.

Events and Notifications

Email templates now include a built-in countdown timer, allowing you to insert a visual countdown timer into email notifications for time-sensitive events, such as campaigns, re-engagement offers, or limited-time promotions.

See Insert multimedia components into email templates.

Events and Notifications

Email templates now support embedded videos powered by YouTube or Vimeo, allowing richer content to be included in email notifications.

See Insert multimedia components into email templates.

Events and Notifications

You can now view detailed metrics about email notifications when using Advanced SMTP server. The details include whether and when emails were successfully delivered, whether they were opened or clicked by recipients, and other delivery and engagement metrics.

See Report on notification histories.

Mediation

We have included a HTTP Processor meter component that lets you make API calls to external services for real-time event enrichment. For example, you can use it to rate events externally or to fetch tax rates from third-party systems.

This feature is in the Early Availability phase. If you want to have access to the feature, submit a request at Zuora Global Support.

Mediation

You can now download large volumes of error records in the audit trail using an export job. Previously, the Meter Run page in Mediation limited downloads to 10,000 records.

Mediation

You can now filter billable subscription statuses (Active and Cancelled) in the Enrichment Processor meter component. By default, the Enrichment Processor continues to enrich all subscription statuses (including Expired, Draft, and others). With this enhancement, users can focus on billing-related subscriptions and avoid enriching non-billable data.

Zuora REST API

We have updated the endpoint for each of the following Object Query API operations to ensure naming consistency. The legacy endpoints are still supported for backward compatibility.

  • List delivery adjustments: From /object-query/delivery-adjustment to /object-query/delivery-adjustments

  • Retrieve a delivery adjustment: From /object-query/delivery-adjustment/{key} to /object-query/delivery-adjustments/{key}

  • List fulfillments: From /object-query/fulfillment to /object-query/fulfillments

  • Retrieve a fulfillment: From /object-query/fulfillment/{key} to /object-query/fulfillments/{key}

  • List ramps: From /object-query/ramp to /object-query/ramps

  • Retrieve a ramp: From /object-query/ramp/{key} to /object-query/ramps/{key}

Zuora REST API

We've added natural key support for the following operations:

  • Retrieve a delivery adjustment

  • Retrieve a fulfillment

  • Retrieve a ramp

You can now specify either the object ID or the object number when calling these endpoints. Previously, only the object ID was supported.

Zuora Protect

Zuora now supports streaming Audit events to external systems using Audit APIs. With the new Splunk integration, administrators and security teams can route user management and billing-related events directly into Splunk for real-time monitoring, analysis, and alerting.

Zuora OneID

For Multi-Org–enabled Billing tenants, administrators can now update users' Organization Units directly in OneID.

Zuora OneID

Administrators can now track user-management actions and billing transaction changes in the enhanced Audit Trail experience. This enhancement improves visibility into system activities and data updates, helping organizations strengthen monitoring and compliance.

Analytics

Zuora's Consumption Insights has now reached Generally Availability with a production-grade, scalable solution designed for global adoption and seamless platform integration.Key enhancements include:
  • Localization Support: Multi-language and regional format support for global users.
  • Self-Serve Enablement: Streamlined setup and access through UI permissions.
  • Demo Data Generation: Sample datasets to support internal enablement, customer trials, and sales demos.
  • Refined Terminology & UI Updates: Consistent terminology changes from "Billable Usage" to "Billed Usage" across all dashboards, insights, and metrics for clarity and alignment.
  • Enhanced Insights Views: Improved labeling, info icons, and reorganized data order for easier analysis of usage trends, growth, and risk accounts.
These updates ensure better usability, accuracy, and scalability.

Platform 2025.Q4 fixes

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