DioxusLabs/dioxus · error

Hydration is not enabled. Please enable the `hydrate` featur

Error message

Hydration is not enabled. Please enable the `hydrate` feature.

What it means

The web renderer attempted to hydrate an SSR-rendered page but the `hydrate` feature is not enabled on dioxus-web. Hydration paths only exist behind that feature; without it the rehydrate flow cannot run.

Source

Thrown at packages/web/src/lib.rs:160

                    document::init_fullstack_document();
                });
                // Build the vdom without emitting mutations: the SSR DOM is
                // already in place, so hydration binds it afterward.
                virtual_dom.rebuild_in_place();
            });

            let rx = websys_dom.rehydrate(&mut virtual_dom).unwrap();
            hydration_receiver = Some(rx);

            #[cfg(feature = "mounted")]
            {
                // Flush any mounted events that were queued up while hydrating
                websys_dom.flush_queued_mounted_events();
            }
        }
        #[cfg(not(feature = "hydrate"))]
        {
            panic!("Hydration is not enabled. Please enable the `hydrate` feature.");
        }
    } else {
        virtual_dom.rebuild(&mut websys_dom);

        websys_dom.flush_edits();
    }

    loop {
        // if virtual dom has nothing, wait for it to have something before requesting idle time
        // if there is work then this future resolves immediately.
        #[cfg(all(feature = "devtools", debug_assertions))]
        let template;
        #[allow(unused)]
        let mut hydration_work: Option<SuspenseMessage> = None;

        {
            let work = virtual_dom.wait_for_work().fuse();
            pin_mut!(work);

View on GitHub (pinned to 24f6a829df)

Solutions

1. Enable the hydrate feature on dioxus-web to use hydration.

When it happens

Trigger: Thrown at packages/web/src/lib.rs:160 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of DioxusLabs/dioxus@24f6a829df (2026-08-23). Data as JSON: /api/errors/3e76182c599cb8f2. Report an issue: GitHub.