Orbeon Forms 2025.1
Wednesday, December 31, 2025
Today we released Orbeon Forms 2025.1! This release introduces new features, many improvements, and bug-fixes!
Major new features
Built-in confirmation page
The Confirmation page is a page which is intended to show after form processing has completed. For example, a user might have submitted their data, and you want to show a confirmation message, along with next steps.

The Confirmation page is made of two parts:
A user interface in Form Builder, where you can specify what message to show and some options.
Configuration properties to enable and customize the confirmation page behavior.
Messages, like other information in your form, can be fully localized by language.

See also:
Documentation: Confirmation page
Dark mode
A new dark mode is now available in Orbeon Forms. This mode can be enabled using configuration properties.

See also:
Documentation: Color scheme
Keyboard Shortcuts dialog
Form Builder now includes a dedicated Keyboard Shortcuts dialog that lists all available shortcuts, allowing you to discover them without leaving the app.

See also:
Pluggable detail page modes
With Orbeon Forms 2025.1, we are introducing custom modes. This enables two new different features for integrators:
Custom Views: Showing existing form data in custom ways, for example showing a subset of the form data for confirmation.
External Navigation: Navigating away from and back to Orbeon Forms, for example for calling external services such as payment and signature providers. The good news is that Orbeon Forms handles for you the difficult parts: data management, state keeping, and permissions, in particular, while you can concentrate on your custom mode logic. The following diagram summarizes the overall flow:

See also:
Blog post: Custom Form Runner modes
Documentation: Form Runner custom modes
Improved languages support
In this version, we have greatly increased the number of supported languages in Orbeon Forms:
All languages that were only partially supported before are now fully supported.
We've added Polish, Arabic, and Japanese support for both Form Runner and Form Builder.
We've also added Catalan, Chinese (Simplified), Chinese (Traditional), Hungarian, and Turkish support for Form Runner.
Here is the full list:
Arabic
F
F
Catalan
F
N
Chinese (Simplified)
F
N
Chinese (Traditional)
F
N
Danish
F
N
Dutch
F
F
English
F
F
Finnish
F
F
French
F
F
German
F
F
Hungarian
F
N
Italian
F
F
Japanese
F
F
Norwegian
F
F
Polish
F
F
Portuguese
F
F
Russian
F
F
Spanish
F
F
Swedish
F
F
Turkish
F
N
See also:
Documentation: Supported languages
CSS variables
In this version, we have refactored our CSS files to use CSS variables. This makes it easier to customize the look-and-feel of Orbeon Forms to your own needs. Variables control various aspects of the appearance of forms, including:
font sizes
colors
In the future, we plan to introduce configuration user interface for themes in Orbeon Forms.
See also:
Documentation: CSS variables
Allowing colors in PDF output
A new PDF color mode allows preserving colors, and CSS variables related to colors can be overridden in a custom @media print section and will be used by the PDF generator.
See also:
Documentation: PDF color mode
New demo forms
In 2025, we have added a number of new demo forms to showcase various features of Orbeon Forms. These forms are available online as well as in the Orbeon Forms distribution:
Removal of Ehcache 2 and use of Infinispan
We have removed Ehcache 2.x as the default caching provider, as that library is no longer supported. Orbeon Forms now uses Infinispan as the default caching provider. Infinispan can also be used as a provider for a replication setup.
See compatibility notes below for details and backward compatibility information.
See also:
Documentation: JCache configuration with Infinispan
Revision History API improvements
The Revision History API can now directly return differences.
See also:
Documentation: Revision History API: Parameters
New and improved APIs
Sending emails with the SendGrid Email API
In addition to sending emails with SMTP servers, we are introducing support for sending emails through the SendGrid Email API.
See also:
Documentation: Form Runner email configuration properties
Remote server APIs
This new API allows you to perform remote operations:
Push to remote
Pull from remote
See also:
Documentation: Remote server APIs
Property provider API
This new server-side Java API allows adding custom property providers to supply property values from alternative sources or through custom logic. Use cases include:
providing configurations stored in a database
providing passwords or keys from a secure vault or Key Management System (KMS)
providing preferences linked to a user profile
providing properties for a particular tenant in a multi-tenant setup
See also:
Documentation: Property provider API
Features also included with Orbeon Forms 2024.1.x
Features also included with Orbeon Forms 2024.1.1
Features also included with Orbeon Forms 2024.1.2
Features also included with Orbeon Forms 2024.1.3
Other new features and enhancements
Orbeon Forms 2025.1 also includes many other new features and enhancements, including all enhancements present in Orbeon Forms 2024.1.x releases. Some of the highlights are:
Support for new custom validation "Maximum number of files", on multiple attachment controls (#6737)
Minimum Number of Files per Control validation for Multiple File Attachments (#7333)
Store attachment hash in form data, pass hash to persistence, store hash in relational database (#6982)
WebP support in PDF (#7109)
When the date format uses leading zeros, allow dates to be entered without separators (#7122)
Option to fully disable the landing page (#7201) (2024.1.3)
Pager: add page selection dropdown/field (#7200) (2024.1.3)
Improve wizard.focus() to handle pager (#7202) (2024.1.3)
Use dropdown with search for language selector in Add Language dialog (#7233)
Include the form's schema (XSD) along form definition in the zip export (#7303)
Provide analyze-string() in JVM environment (#7354) (2024.1.4)
xf:instance to support xxf:xinclude="true" (#7367)
Repeated grids/sections: support paging (#4137) (2024.1.3)
JavaScript API for repeated section paging (#7183) (2024.1.3)
Ability for form authors to select the default sort column (#7144)
Compatibility and upgrade notes
Legacy custom XForms JavaScript events
These long undocumented events are no longer dispatched on the client side:
fullUpdateEventtypeChangedEvent
Log4j 1.x compatibility
Support for using Log4j 2.x in Log4j 1.x compatibility mode has been removed. If you were using Log4j 1.x configuration files (log4j.xml), please migrate to Log4j 2.x and use log4j2.xml.
Removal of deprecated date/time functions
The following deprecated date/time functions (since 2017!) have been removed. Please use the suggested alternatives.
fr:created-date(): usefr:created-dateTime()fr:modified-date(): usefr:modified-dateTime()
Ehcache 2.x changes and deprecation
Support for Ehcache 2.x as a caching provider is deprecated and will be removed in a subsequent release. The Ehcache 2.x JAR file is no longer provided. If you are using Ehcache 2.x, please migrate to using a JCache provider, such as Infinispan, which is now the default.
If this is not convenient or possible in the short term, you can still, at of Orbeon Forms 2025.1, configure Ehcache 2.x as the caching provider by adding the Ehcache 2.x JAR file to Orbeon Forms' classpath and setting the following property in properties-local.xml:
See also:
Documentation: JCache configuration with Infinispan
Last updated