+++ title = "hx-headers" description = """\ The hx-headers attribute in htmx allows you to add to the headers that will be submitted with an AJAX request.""" +++ The `hx-headers` attribute allows you to add to the headers that will be submitted with an AJAX request. By default, the value of this attribute is a list of name-expression values in [JSON (JavaScript Object Notation)](https://www.json.org/json-en.html) format. If you wish for `hx-headers` to *evaluate* the values given, you can prefix the values with `javascript:` or `js:`. ```html
Get Some HTML, Including A Custom Header in the Request
Get Some HTML, Including a Dynamic Custom Header from Javascript in the Request
``` ## Security Considerations * By default, the value of `hx-headers` must be valid [JSON](https://developer.mozilla.org/en-US/docs/Glossary/JSON). It is **not** dynamically computed. If you use the `javascript:` prefix, be aware that you are introducing security considerations, especially when dealing with user input such as query strings or user-generated content, which could introduce a [Cross-Site Scripting (XSS)](https://owasp.org/www-community/attacks/xss/) vulnerability. * Whilst far from being a foolproof solution to [Cross-Site Request Forgery](https://owasp.org/www-community/attacks/csrf), the `hx-headers` attribute can support backend services to provide [CSRF prevention](https://cheatsheetseries.owasp.org/cheatsheets/Cross-Site_Request_Forgery_Prevention_Cheat_Sheet.html). For more information see the [CSRF Prevention](https://htmx.org/docs/#csrf-prevention) section. ## Notes * `hx-headers` is inherited and can be placed on a parent element. * A child declaration of a header overrides a parent declaration.