Enable Automatic HEAD Responses

Estimated reading time: 1 minute

Ktor can automatically provide responses to HEAD requests for existing routes that have the GET verb defined.

This feature is defined in the class io.ktor.features.AutoHeadResponse and no additional artifacts are required.


To enable automatic HEAD responses, install the AutoHeadResponse feature

fun Application.main() {
  // ...
  // ...

Configuration options


Under the covers

This feature automatically responds to HEAD requests by routing as if it were GET response and discarding the body. Since any FinalContent produced by the system has lazy content semantics, it does not incur in any performance costs for processing a GET request with a body.