FormBuilder onChange callback not triggered when options prop is provided
@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:
- Create a Next.js project and dynamically import
FormBuilder:
const FormBuilder = dynamic(
() => import('@formio/react').then((module) => module.FormBuilder),
{ ssr: false }
)
- Define a simple onChange callback:
const handleFormChange = (schema: FormType) => {
console.log('i handled the change')
}
- 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.)
- Interact with the FormBuilder UI (add/remove/update components).
- 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
- No Dockerfile or Docker Compose file
- Has a pull request template
- Read the contributing guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
More from formio/react
-
Difficulty 3/5 1-2 days Newbie friendliness 64/100
-
Difficulty 3/5 1-2 days Newbie friendliness 55/100
-
onChange `modified` property remains false when file component is updatedMay be free again @ZenMasterJacob20011 claimed this 295 days ago, and no pull request is open. Open
-
FormBuilder with OnChange broke textareaMay be free again @lane-formio claimed this 309 days ago, and no pull request is open. Open
-
Difficulty 3/5 1-2 days Newbie friendliness 30/100
Similar issues
-
`@angular/[email protected]` depends on vulnerable Vite 7.3.7 - GHSA-p4f5-76q4-ffq7 (Critical RCE)Openarea: @angular/build
Difficulty 2/5 1-3 hours Newbie friendliness 65/100
angular/angular-cli#34764 ·
Maintainers usually reply within 1 day
-
status/need-triage
Difficulty 2/5 1-3 hours Newbie friendliness 76/100
google-gemini/gemini-cli#30384 · 1 comment ·
Maintainers usually reply within 1 day
-
P2
Difficulty 1/5 Under an hour Newbie friendliness 84/100
Maintainers usually reply within 1 day
-
bug ready-for-human
Difficulty 2/5 1-3 hours Newbie friendliness 60/100
LucasSantana-Dev/Lucky#3150 ·
Maintainers usually reply within 1 day
-
enhancement good first issue priority: low size: XS
Difficulty 2/5 1-3 hours Newbie friendliness 88/100
Maintainers usually reply within 1 day