@ory/elements-react 1.2.0

Ory Elements v1.2.0 is now generally available.

To install the updated version:

npm install @ory/elements-react@1.2.0

Please read the below guide before upgrading to see if you're affected by the full custom component support change.

Also note that future releases of Ory Elements will follow Ory's standardized OSS versioning schema and no longer follow the current semver-like model.

Full custom components support

This release adds support for fully custom components in @ory/elements-react.

Previously, only a limited set of components could be customized. Now, developers can provide their own React components for a wide range of UI elements, allowing for greater flexibility and consistency with their application's design system.

Upgrade Guide:

If you are current overriding components using the components prop, you may need to update your overrides to pass the correct props to your custom components.

• Node.Button: Now receives additional props:
  • isSubmitting: This prop indicates whether this button was used to submit
    the form and the form is currently submitting.
  • buttonProps: This prop contains all other button-related props that should
    be spread onto the button element.
• Node.Input: Now receives additional props:
  • inputProps: This prop contains all other input-related props that should
    be spread onto the input element.
• Node.Checkbox:
  • inputProps: This prop contains all other checkbox-related props that
    should be spread onto the checkbox input element.
• Node.ConsentScopeCheckbox:
  • inputProps: This prop contains all other checkbox-related props that
    should be spread onto the checkbox input element.
• Node.Label:
  • fieldError: This prop contains the error message associated with the field, if any.
• Settings Pages:
  • Each settings section now similarly receives the nodes with a buttonProps
    or inputProps prop, depending on the type of node.

Fixes

• If you were using the RecoveryCodesSettings component, there was a typo in the prop name for regenerating codes. The correct prop name is now regenerateButton instead of regnerateButton.

Renamed AccountExperienceConfiguration to ProjectConfiguration

In order to make Ory Elements' naming more clear to the end user, the AccountExperienceConfiguration type has been renamed to ProjectConfiguration.

Built in support for 83 languages

Ory Elements now ships with built in support for 83 languages. Each language contains all messages rendered by Ory Elements nodes.

Additionally, custom translations may be provided to each of the self service components to fully customize the messages and text paragraphs shown to end-users.

Read more: https://www.ory.com/docs/elements/guides/internationalization

Autofocus on the first input field of the auth forms

This change adds autofocusing behavior to the first input field of the authentication forms, improving user experience by allowing users to start typing immediately without having to click on the input field first.

Event lifecycle callback props in Ory Elements

The self-service flow components in Ory Elements now expose onSuccess, onValidationError, and onError props that allow you to handle form submissions and receive events for success, validation errors, and failed flows.
This allows you to forward these events to your own analytics or tracking tools, giving you better insights into user interactions with the self-service flows.

Docs: https://www.ory.com/docs/elements/guides/events

transient_payload in form submissions

The self-service flow components now support customization of the transient_payload property during flow submissions. This allows you to add context to form submissions, such as tracking cookie values, referrer references, and more.

Read more about transient_payload: https://www.ory.com/docs/elements/guides/transient-payload

Hide registration link

The registration link on the login page can now be hidden independently of whether self-service registration is enabled in Kratos.

Enum traits support

Traits defined as enums are now rendered as drop-downs in self-service registration and settings forms.

Bug Fixes

Settings URL in user menu

The user menu entry for the settings now correctly uses the settings UI Url from the project configuration.

Conditional CAPTCHA Rendering

Updated the CAPTCHA component to only display when user interaction is actively required, rather than appearing on every screen, reducing visual clutter.

Properly handle 2FA requirement in recovery flows

When a user has any 2FA method enabled and Kratos is configured to require 2FA for settings flows, Ory Elements did not properly handle the error returned by Kratos when trying to complete a recovery flow. This has now been fixed.

Submit state management in Ory Elements React

When the user is being redirected away to a different page or domain, the submit button that was clicked now remains in a loading state, preventing the user from clicking it twice, which can lead to confusion.

release/@ory/nextjs/1.0.0-rc.1

1.0.0-rc.1 (2026-02-03)

🚀 Features

• recovery with any address including with a code via SMS (06988873)

🩹 Fixes

• update ory/client-fetch to properly handle 403 during recovery flows (f95ee915)
• handle immutable headers returned by native fetch in middleware (50017215)
• routes in AX with identity_schema (31c31b7b)
• deps: update dependency @ory/client-fetch to v1.21.4 (d56e1640)
• ⚠️ elements: fully document and streamline component naming (df9d0e1b)
• update base hostname to be used from the header instead of using nextUrl host (cafa8166)
• default theme styling issues (590e5b46)

⚠️ Breaking Changes

• ⚠️ elements: fully document and streamline component naming (df9d0e1b)

❤️ Thank You

• Henning Perl @hperl
• Jonas Hungershausen
• ory-bot @ory-bot
• Philippe Gaultier @gaultier
• Pierre Caillaud @pcaillaudm

release/@ory/elements-react/1.1.0

1.1.0 (2025-09-10)

🚀 Features

• scope default theme CSS to .ory-elements (a708dd08)
• console UI for multiple identity schemas (ca789248)
• changelog-oel: choose identity schema in self-service registration and login flows (5086f519)
• recovery with any address including with a code via SMS (06988873)

🩹 Fixes

• adjust check for runtime detection to allow edge runtime (2b2fe6aa)
• use settings ui URL in user menu (65f59bd7)
• login otp sent message (fdabadf8)
• routes in AX with identity_schema (31c31b7b)
• don't remove OIDC buttons if invalid identifier is submitted (416e3c6e)
• _ORY_SDK_URL to ORY_SDK_URL (8f3d078a)
• theming view nit fixes (69d7cf91)

❤️ Thank You

• Henning Perl @hperl
• Jonas Hungershausen
• ory-bot @ory-bot
• Philippe Gaultier @gaultier
• Pierre Caillaud @pcaillaudm

@ory/elements-react 1.0.0

We're thrilled to announce 1.0.0 of @ory/elements-react. Ory Elements is an open-source component library designed to make building login, registration, and account pages straightforward. Ory Elements is modular and customizable, which means that you can use only the views you need and style them to match your implementation's design.

---

• Read the docs: https://www.ory.sh/docs/elements
• Get Started with the Ory Network: https://console.ory.sh/registration
• If youre currently using an earlier version of the Ory Elements libraries, read our upgrade guide or reach out to us

release/@ory/elements-react/1.0.0-rc.6

1.0.0-rc.6 (2025-07-10)

🚀 Features

• add norwegian translations (b1b0ed9d)
• use vendored ory/x (23dbc943)
• add "Recover Account" to identifier label (81271d24)
• show settings validation messages as toasts (afbabb9b)
• elements: use existing IntlContext if available (20c28207)
• add a project revision field to set the maximum number of code submits (2c0998c5)
• submit passkey from method chooser (901fa1bc)

🩹 Fixes

• ⚠️ elements: fully document and streamline component naming (df9d0e1b)
• german locale translation (5a947c2c)
• ax: render webauthn hidden only once (dfefff40)
• disable interactive elements before hydration complete (5c3299bf)
• add card header detection for profile_first (2b12c9f5)
• use formState dispatcher in registration footer (9b200ab1)
• default theme styling issues (590e5b46)

⚠️ Breaking Changes

• ⚠️ elements: fully document and streamline component naming (df9d0e1b)

❤️ Thank You

• Henning Perl @hperl
• Jonas Hungershausen
• ory-bot @ory-bot
• Philippe Gaultier @gaultier
• Pierre Caillaud @pcaillaudm

v0.5.1

What's Changed

• feat: add Chinese translation by @GWnbsp in #278
• fix: brand logic by @hperl in #348

New Contributors

• @GWnbsp made their first contribution in #278

Full Changelog: v0.5.0...v0.5.1

v0.5.0

What's Changed

• feat: add russian translation by @Totozao in #204
• chore: update english locale by @jonas-jonas in #207

New Contributors

• @Totozao made their first contribution in #204

Full Changelog: v0.4.0...v0.5.0

v0.4.0

What's Changed

• feat: show a specific cancel message on account linking form by @jonas-jonas in #198
• feat: update German, French, and Dutch locales by @zepatrik in #203
• feat: add support for captchas by @jonas-jonas in #200

Full Changelog: v0.3.0...v0.4.0

v0.4.0-rc.3

fix: captcha script group

v0.4.0-rc.2

chore: support registration, verification & recovery