/Knowledge/sources/honojs__hono/llms-full/best-practices-head-request-best-practices-don-t-try-to-create-dedicated-head-handlers--742fe31f7488.md

Best Practices: HEAD Request Best Practices > ❌ Don't: Try to Create....

Best Practices: HEAD Request Best Practices ❌ Don't: Try to Create Dedicated HEAD Handlers Source evidence: /Sources/honojs hono/provenance.md Canonical cita...

Best Practices: HEAD Request Best Practices > ❌ Don't: Try to Create Dedicated HEAD Handlers

Source evidence: /Sources/honojs__hono/provenance.md Canonical citation: https://hono.dev/llms-full.txt#don-t-try-to-create-dedicated-head-handlers

Summary


## Content
```typescript
// BAD: This won't work as expected
app.head('/api/users', (c) => {
  // This handler will NEVER be called
  c.header('X-Custom', 'value')
  return c.text('ignored')
})

// BAD: Using on() also won't work
app.on('HEAD', '/api/users', (c) => {
  // Still converted to GET before route matching
})

Metadata

{
  "chunk_index": 0,
  "citation": "https://hono.dev/llms-full.txt#don-t-try-to-create-dedicated-head-handlers",
  "coverage_role": "overview",
  "qualified_title": "Hono / llms-full / Best Practices > HEAD Request Best Practices > \u274c Don't: Try to Create Dedicated HEAD Handlers",
  "retrieved_at": "2026-07-02T05:51:01Z",
  "section_index": 84,
  "source_id": "/honojs/hono",
  "source_type": "llms_full",
  "target_label": "llms-full",
  "title": "Best Practices: HEAD Request Best Practices > \u274c Don't: Try to Create Dedicated HEAD Handlers",
  "upstream_url": "https://hono.dev/llms-full.txt",
  "version": "2026"
}
Kinic Wiki
Loading knowledge node
Details

Identity

database
db_23dhmsxlhukv
database_id
db_23dhmsxlhukv
path
/Knowledge/sources/honojs__hono/llms-full/best-practices-head-request-best-practices-don-t-try-to-create-dedicated-head-handlers--742fe31f7488.md
kind
directory
role
markdown_note
children
0

Metadata

created_at
virtual
updated_at
virtual
etag
virtual
metadata_json
{}

Lint Hints

No lightweight warnings.

Outgoing Links

No outgoing links indexed.

Incoming Links

Select a file node to inspect backlinks.

Raw Source

No raw source path inferred.