> For AI agents: the complete documentation index is at [llms.txt](https://reflex.dev/docs/llms.txt). For a Markdown version, remove the trailing slash from the page URL and append `.md`. The docs home is available at [index.md](/docs/index.md).

## v0.11.0 (2026-11-11)

### Deprecations

- Removal of form controls submitting their value under their `id` is postponed from 0.11 to 0.12; give each control a `name` before then. ([#7789](https://github.com/reflex-dev/reflex/issues/7789))

### Bug Fixes

- `rx.foreach` over a string now iterates Unicode code points, so a character such as an emoji is no longer split into lone surrogates. ([#7548](https://github.com/reflex-dev/reflex/issues/7548))
- `rx.match` is now typed as returning a `Component` when its cases return components and a `Var` when they return values, so a function returning it can be annotated with either. ([#7750](https://github.com/reflex-dev/reflex/issues/7750))
- An upload handler that raises now gets an HTTP 500 when no update was streamed yet, or ends the stream with an `{"error": ...}` frame that `rx.upload_files` reports, instead of a truncated response that looked successful. The backend exception handler receives the full traceback, and the server no longer logs the exception twice. ([#7808](https://github.com/reflex-dev/reflex/issues/7808))


## v0.10.1 (2026-10-26)

### Deprecations

- Submitting a form control's value under its `id` is deprecated and will be removed in 0.11; form data will then hold only what each control submits under its `name`. Compiling a form whose `on_submit` handler takes the form data now warns about each value-bearing control that has a static `id` but no `name`; give it a `name`, e.g. `rx.input(id="email")` becomes `rx.input(id="email", name="email")`. A control whose `id` differs from its `name` also stops adding a field keyed by its `id`, and a checkbox or switch whose `id` equals its `name` submits `"on"` or nothing instead of `True` or `False`; read it as a `bool` field of a `TypedDict` to keep a bool. See the [form docs](https://reflex.dev/docs/library/forms/form/) for details. ([#7386](https://github.com/reflex-dev/reflex/issues/7386))

### Bug Fixes

- Forms now see the `name` of a controlled input (one with `value` and `on_change`), so a `TypedDict` submit handler requiring that field no longer fails to compile. ([#7386](https://github.com/reflex-dev/reflex/issues/7386))
- The default connection toast shows a hydration size error at once and keeps it open until the user closes it. ([#7551](https://github.com/reflex-dev/reflex/issues/7551))
- `window_event_listener` and `clipboard` hooks now render in declaration order with the rest of the component's hooks instead of being moved after them. ([#7586](https://github.com/reflex-dev/reflex/issues/7586))


## v0.10.0 (2026-10-08)

### Breaking Changes

- Require Python 3.11 or newer; Python 3.10 is no longer supported. ([#7449](https://github.com/reflex-dev/reflex/issues/7449))

### Features

- The connection banner reads `REFLEX_BACKEND_COLD_START_TIMEOUT` as a duration, so it accepts a unit suffix such as `30s`. A bare number is still read as seconds. ([#7138](https://github.com/reflex-dev/reflex/issues/7138))

### Bug Fixes

- Fix `rx.match` raising `ReferenceError: Can't find variable` at render when a state Var is used only in a case condition with component branches. ([#6675](https://github.com/reflex-dev/reflex/issues/6675))
- Exclude IDs on forms and other non-controls from form submissions while preserving unset ID-backed controls and supporting custom controls marked with `_is_form_control`. ([#7227](https://github.com/reflex-dev/reflex/issues/7227))

### Miscellaneous

- Update react-dropzone to 17.0.0 and react-error-boundary to 6.1.6. ([#7424](https://github.com/reflex-dev/reflex/issues/7424))


## v0.9.10.post1 (2026-09-21)

### Bug Fixes

- Require `reflex-base >= 0.9.12`. The declared floor was older than the `reflex_base.components.tags.CommonTag` import this package relies on, so a resolver was free to pair it with a `reflex-base` that fails at import time with `ImportError: cannot import name 'CommonTag'`. ([#7268](https://github.com/reflex-dev/reflex/issues/7268))


## v0.9.10 (2026-09-21)

### Bug Fixes

- `rx.el.svg` and its children now render as one memoized component, so `defs` such as gradients and the elements that reference them by id always share one render scope. ([#6708](https://github.com/reflex-dev/reflex/issues/6708))
- `rx.debounce_input` (which fully-controlled inputs compile to) now delivers a parent-provided ref to the underlying input element instead of the component instance, fixing crashes under `rx.form.control(..., as_child=True)`. ([#6850](https://github.com/reflex-dev/reflex/issues/6850))
- Return a controlled 400 response when an upload request references an unknown event handler. ([#6860](https://github.com/reflex-dev/reflex/issues/6860))
- Give the Built with Reflex badge an accessible name when its visual text is hidden on small screens. ([#7078](https://github.com/reflex-dev/reflex/issues/7078))
- `reflex_components_core.datadisplay` no longer advertises `code_block`, `data_editor` and friends: those moved to the standalone `reflex-components-code` and `reflex-components-dataeditor` packages, so accessing them here raised `ModuleNotFoundError`. Reach them as before via `rx.code_block` / `rx.data_editor`, or `reflex.components.datadisplay.code`. ([#7124](https://github.com/reflex-dev/reflex/issues/7124))
- Stop the default error boundary fallback from logging invalid DOM property warnings for its SVG icon. ([#7130](https://github.com/reflex-dev/reflex/issues/7130))

### Miscellaneous

- Annotate `_render` overrides as returning `CommonTag`, the new base of every tag class. ([#7121](https://github.com/reflex-dev/reflex/issues/7121))


## v0.9.9 (2026-08-28)

### Features

- The "Built with Reflex" badge appends a urlencoded `ref` query parameter to its reflex.dev link when the `REFLEX_REFERRER_PARAM` environment variable is set at compile time. ([#6951](https://github.com/reflex-dev/reflex/issues/6951))

### Bug Fixes

- Sanitize buffered upload filenames the same way streamed upload filenames are sanitized. ([#6753](https://github.com/reflex-dev/reflex/issues/6753))
- `rx.script` head updates now flush synchronously instead of via react-helmet's requestAnimationFrame batching, fixing intermittently missing script tags after hydration (flaky "scripts not loaded" failures). ([#6905](https://github.com/reflex-dev/reflex/issues/6905))
- Upload filenames whose segments contain nothing but dots and spaces (e.g. `".."`, `"./../."`, `".. "`) now sanitize to the fallback name `upload` instead of returning the bare segment. Such names pointed the saved path outside the upload directory — directly on POSIX, and via Win32's trailing dot/space trimming on Windows — and crashed the upload handler with a 500. ([#6971](https://github.com/reflex-dev/reflex/issues/6971))

### Miscellaneous

- Hoist the `RegistrationContext` import in the upload handler to module level. ([#6382](https://github.com/reflex-dev/reflex/issues/6382))
- Internal logging migrated from the legacy console helpers to standard python `logging` per-module loggers. ([#6864](https://github.com/reflex-dev/reflex/issues/6864))
- Property docstrings are now noun phrases rather than "Get the ..." / "Return the ..." (ruff 0.16's new `D421`). ([#6893](https://github.com/reflex-dev/reflex/issues/6893))


## v0.9.8 (2026-08-04)

### Miscellaneous

- Bumped `react-error-boundary` 6.1.1 → 6.1.2. ([#6678](https://github.com/reflex-dev/reflex/issues/6678))


## v0.9.7 (2026-07-15)

### Miscellaneous

- `rx.upload` internals use `ArrayVar.map` instead of the deprecated `foreach`. ([#6701](https://github.com/reflex-dev/reflex/issues/6701))


## v0.9.6 (2026-06-25)

### Bug Fixes

- Deliver extra bound handler arguments to upload handlers, so `on_drop=State.handle_upload(rx.upload_files(...), field)` passes `field` through to the backend instead of raising a missing-argument error. ([#5290](https://github.com/reflex-dev/reflex/issues/5290))
- Preserve literal string types through `rx.cond`, so `rx.cond(State.flag, "green", "red")` infers `Var[Literal["green", "red"]]` instead of widening to `Var[str]` and tripping Pyright on props typed as `Literal[...] | Var[Literal[...]]` such as Radix `color_scheme`. ([#6545](https://github.com/reflex-dev/reflex/issues/6545))
- `rx.debounce_input` no longer crashes the page with `ReferenceError: input is not defined` when wrapping a native DOM element such as `rx.el.input` or `rx.el.textarea`. The `element` prop now passes global-scope tags as string literals (`element:"input"`), while library components keep referencing their imported identifiers. ([#6637](https://github.com/reflex-dev/reflex/issues/6637))


## v0.9.5 (2026-06-10)

### Features

- `Form` now validates statically-knowable fields against a `TypedDict`-annotated `on_submit` handler at create time: it walks nested form controls (including components nested in props), collects their static `name`/`id` values, and raises `EventHandlerValueError` listing the missing and present fields when a required `TypedDict` field has no matching control. `input`, `select`, and `textarea` are marked as form controls so their identifiers are collected, and required-field resolution honors `NotRequired` across Python 3.10 and 3.11+. The `on_submit` handler signature also accepts a mapping-style payload via `on_submit_mapping_event`. ([#6301](https://github.com/reflex-dev/reflex/issues/6301))

### Miscellaneous

- The connection-error banner now subscribes only to the dedicated `CONNECT_ERRORS` hook instead of the shared events hook, and the upload component declares its `UploadFilesProvider` through `VarData.app_wraps` rather than `Upload._get_app_wrap_components`. ([#6447](https://github.com/reflex-dev/reflex/issues/6447))
