HX-Retarget ~ htmx

The HX-Retarget response header overrides the element that will receive the swapped content, replacing whatever hx-target was set on the triggering element.

Syntax


HX-Retarget: #new-target

The value is a CSS selector for the new target element.

Example

Redirect a form submission result to a different container:


return Response(
    content,
    headers={'HX-Retarget': '#notifications'}
)

Notes

Overrides hx-target on the source element
Evaluated after the response is received, before swapping