Whatever message this page gives is out now! Go check it out!

cfheader

Last update:
May 18, 2026

Description

Generates custom HTTP response headers to return to the client.

Category

Syntax

<cfheader
charset="character set"

name = "header name"

value = "header value">

OR

<cfheader

statusCode = "status code"

>
Note: You can specify this tag's attributes in an attributeCollection attribute whose value is a structure. Specify the structure name in the attributeCollection attribute and use the tag's attribute names as structure keys.

See also

History

ColdFusion (2025 release): Removed the statusText attribute. See Deprecated features in ColdFusion for more information.
ColdFusion MX 6.1: Changed behavior for the name attribute: cfheader name="Content-Disposition" uses the default file character encoding to encode this header's value, so the name of a file can include characters in the character encoding used in the file.

Attributes

Attribute
Req/Opt
Default
Description
charset
Optional
UTF-8
The character encoding in which to encode the header value. The following list includes commonly used values:
name
Required if statusCode not specified
Header name.
statusCode
Required if name not specified
Number. HTTP status code.
value
Optional
HTTP header value.

Usage

If you use this tag after the cfflush tag on a page, an error is thrown.

Example

<h3>cfheader Example</h3> 

<p>cfheader generates custom HTTP response headers to return to the client. 
<p>This example forces browser client to purge its cache of requested file. 
<cfheader name="Expires" value="#GetHttpTimeString(Now())#">

Share this page

Was this page helpful?
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Thank you for your feedback. Your response will help improve this page.

On this page