FormBuilder onChange callback not triggered when options prop is provided

Open
#631 1 comment 0 reactions 1 assignee View on GitHub

@Victoriya25 is already working on this.

Since Dec 17, 2025.

Assessment

This issue has not been assessed yet.

Description

Describe the bug
The onChange callback of FormBuilder from @formio/react is not triggered when the options prop is provided. This happens even if options is an empty object (options={{}}). As soon as options is set, form changes made in the builder UI no longer invoke the onChange handler.

Version/Branch
@formio/react: "6.1.1"
Framework: Next.js (App/Pages Router)
Rendering: client-side only (ssr: false via dynamic import)

To Reproduce
Steps to reproduce the behavior:

  1. Create a Next.js project and dynamically import FormBuilder:
   const FormBuilder = dynamic(
     () => import('@formio/react').then((module) => module.FormBuilder),
     { ssr: false }
   )
  1. Define a simple onChange callback:
const handleFormChange = (schema: FormType) => {
  console.log('i handled the change')
}
  1. Render FormBuilder with initialForm, onChange, and any options prop (even an empty object):
<FormBuilder
  initialForm={initialForm}
  onChange={handleFormChange}
  options={{}}
/>

(The same issue occurs with a fully customized options.builder configuration.)

  1. Interact with the FormBuilder UI (add/remove/update components).
  2. Observe that handleFormChange is never called.

Expected behavior
The onChange callback should be triggered whenever the form schema changes in the FormBuilder, regardless of whether the options prop is provided (including options={{}}).

Dominant language
TypeScript
Stars
371
Forks
309
PR merge metrics
No merged PRs in 30d

Getting set up

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

More from formio/react

All issues in formio/react

Similar issues

More TypeScript issues

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.