htmx.config.allowEmptySwapAfterOOB

View as MarkdownOpen this page as Markdown
For LLMs
llms.txthtmx overview for LLMs
llms-full.txtComplete htmx docs for LLMs

Controls whether OOB swaps prevent empty main swaps

On this page

The htmx.config.allowEmptySwapAfterOOB option controls whether out-of-band swaps prevent the main swap when the response body is empty after OOB extraction.

Override it per element with swapEmpty.

Default: false. When false, OOB swaps prevent the empty main swap. When true, the main swap runs even if only OOB elements were in the response.

Note: <hx-partial> elements always prevent empty main swaps regardless of this setting. Partials are designed as true response separators where the server has explicit control.

Values

  • false — OOB swaps prevent the empty main swap (default)
  • true — allow the main swap even after OOB extraction leaves no content

Example

htmx.config.allowEmptySwapAfterOOB = true;
<meta name="htmx-config" content='{"allowEmptySwapAfterOOB":true}'>

Override per element with the swapEmpty modifier on hx-swap:

<!-- skip the main swap on an empty response for this element only -->
<div hx-swap="innerHTML swapEmpty:false"></div>

<!-- force the main swap even on an empty response -->
<div hx-swap="innerHTML swapEmpty:true"></div>