htmx/www/attributes/hx-post.md

layout	title
layout.njk	</> htmx - hx-post

hx-post

The hx-post attribute will cause an element to issue a POST to the specified URL and swap the HTML into the DOM using a swap strategy:

<button hx-post="/account/enable" hx-target="body">
  Enable Your Account
</button>

This example will cause the button to issue a POST to /account/enable and swap the returned HTML into the innerHTML of the body.

Notes

• hx-post is not inherited
• You can control the target of the swap using the hx-target attribute
• You can control the swap strategy by using the hx-swap attribute
• You can control what event triggers the request with the hx-trigger attribute
• You can control the data submitted with the request in various ways, documented here: Parameters