User Guide Cancel

cfheader

 

Description

Generates custom HTTP response headers to return to the client.

Category

Data output tagsPage processing tags

Syntax

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

cfcachecfflushcfhtmlheadcfincludecfsettingcfsilentcfcontent

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())#">
<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())#">
<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())#">

Get help faster and easier

New user?