Files
kumomta/docs/reference/header/value.md
T
Wez Furlong d2f31b4fdf mailparsing: emit MIME-Version with its RFC 2045 canonical spelling
Headers were built and rebuilt as "Mime-Version" rather than
"MIME-Version". Both are valid per RFC 2045, but some spam filters,
such as rspamd, score the mixed-case form as a deliverability signal.
Fix the header name in the accessor macro and in ParsedHeader's
grammar table, the places that spell it, and update the snapshot
tests across mailparsing, message, kumo-log-types, mod-mimepart, and
kumod that captured the old spelling, along with the reference docs
that showed the old casing in their examples. #564
2026-09-28 13:21:16 +01:00

55 lines
1.7 KiB
Markdown

# value
```lua
local value = header.value
```
{{since('2025.10.06-5ec871ab')}}
Depending on the header name, returns one of the structured representations of the header value.
If there is no defined header name and structured representation, the fallback
behavior is to return the same value that you'd see if you accessed
[header.unstructured](unstructured.md).
!!! note
For the sake of forwards compatibility, it is possible that we will add
support for names and structured representations in future versions. In that
scenario, if you were using `header.value` and relying on it returning
the same value as `header.unstructured` then your logic may be broken
by upgrading.
With that in mind, we recommend that you explicitly use `header.unstructured`
in your code for headers that are not included in the table below, rather
than relying on the fallback behavior.
## Supported Header Names and Types
If the `Since` column is blank, it is assumed to be since the inception of `header.value`,
which is the version shown at the top of this page.
|Name|Equivalent field accessor|Since|
|----|----|-----|
|Authentication-Results|authentication_results||
|Bcc|address_list||
|Cc|address_list||
|Comments|unstructured||
|Content-Disposition|mime_params||
|Content-Id|message_id||
|Content-Transfer-Encoding|mime_params||
|Content-Type|mime_params||
|From|mailbox_list||
|Message-ID|message_id||
|MIME-Version|unstructured||
|References|message_id_list||
|Reply-To|address_list||
|Resent-Bcc|address_list||
|Resent-Cc|address_list||
|Resent-From|mailbox_list||
|Resent-Sender|mailbox||
|Resent-To|address_list||
|Sender|mailbox||
|Subject|unstructured||
|To|address_list||