.. epigraph::

   **Gers** *[Gers]• Gaaf/mooi/leuk/geweldig/tof/heel goed*

   -- Rotterdams Woordenboek

Upgrade procedure
-----------------

Ensure that your current version of Open Forms is at least version 2.0.2 before
upgrading.

Version 2.1.0 does not contain breaking changes and therefore upgrading should be
straight forward.

Major features
--------------

A quick summary of the new features in version 2.1 compared to 2.0.

**🌐 Multilingual support**

You can now enter content translations for supported languages (NL/EN) and enable
language selection on a per-form basis. End-users can then pick their preferred language
while filling out a form, defaulting to the browser preferences.

The submission language is registered as metadata in registration backends, and assets
like the confirmation PDF are rendered in the preferred language.

Contact us to add support for additional languages, if desired.

**♿️ Accessibility improvements**

We've scrutinized the markup to find accessibility issues and made big steps in fixing
them. Using Open Forms with a screen reader or other assistive technology should now be
a more pleasant experience. We continue making improvements in this department!

Additionally, it's now possible to specify custom error messages for form components
instead of relying on the default, generic messages.

Finally, the form designer now comes with presets for a number of common form fields,
which provide the appropriate autocomplete configuration.

**🛂 Organization member authentication (OIDC)**

Forms can now be set up for organization member authentication (via OpenID Connect) so
that your employees can start submissions for them.

This functionality is useful for internal forms that should not be filled out by
non-employees, or for employees filling out forms on behalf of a customer. In the latter
case, all the necessary meta-information is registered alongside the form submission
itself.

**💄 Further integration with NL Design System**

We are increasingly adapting the principles and community components under the NL Design
System umbrella, which exposes more and more controls to organizations for themeing Open
Forms to their brand/identity.

**💫 Dynamic options for choice-fields**

You can now use variables as the source of choice options for dropdowns, radio and
checboxes components. Combined with logic, this means you can make these components
dependent on earlier inputs.

**⚗️ Retrieve data from external registrations [Experimental]**

Query data from an external registration/JSON-service based on user input, process the
returned data and subsequently use it in your forms, for example as dynamic dropdown
options!

We're very excited about this feature, but the UX and implementation are not
fully polished yet which is why it is not yet enabled by default.

**🦠 Added support for virus scanning**

We now support (opt-in) virus scanning with `ClamAV <https://www.clamav.net/>`_. Files
uploaded by end-users are passed through the virus scan before they are saved in
Open Forms.

Detailed changes
----------------

Please review the changelog entries for the release candidate and alpha versions of
2.1.0. The changes listed below are compared to the release candidate ``2.1.0-rc.0``.

**Bugfixes**

* [#2804] Fixed the "static variables" not being available in confirmation template
  rendering.
* [#2821] Fixed broken "Map" component configuration screen.
* [#2822] Fixed date components being interpreted as datetimes instead of dates.
* [#2819] Fixed the key and translations of the password field not automatically
  updating with entered content (label and other translatable fields).
* [#2820] Fixed translations not registering initially when adding a component to a new
  form step.
* [#2791] Fixed long words overflowing in the confirmation PDF.
* [#2850] Fixed a crash in the AVG log viewer when certain log records of deleted
  submissions are displayed.
* [#2842] Fixed analytics CSP-integration resulting in a misconfigured policy.
* [#2851] Fixed importing a form while the admin UI is set to English resulting in
  incorrect form translation mappings.
* [#2838] Fixed hidden selectboxes field triggering premature validation of required fields.
* [#2874] Fixed "repeating group" component group label not being translated.