<cflocation>

Redirect the current request to another URL.

For example, you might use <cflocation> to specify a standard message or response that you use in several applications.

Use the addToken attribute to verify client requests.

This tag may have a body.

This tag is also supported within <cfscript>

<cflocation url=string addtoken=boolean abort=boolean statuscode=number encode=boolean ><!--- body --->[</cflocation>]
Attribute Description
url
string, required

The URL of the HTML file or CFML page to open.

addtoken
boolean, optional

Yes or No. clientManagement must be enabled, see cfapplication. Yes appends client variable information to the URL you specify in the url.

abort
boolean, optional

if set to true then the request will be aborted instead of redirected to allow developers to troubleshoot code that contains redirects

Introduced: 6.0.0.114

statuscode
number, optional

statuscode used for the redirect (301 or 302)

encode
boolean, optional

Encode the given URL value (changed behavior in Lucee 6.0)

Introduced: 6.0.0.320

Examples

Syntax for cflocation

<cflocation url="filename.ext" addToken="false">

See also