# CFLOCATION

CFLOCATION opens a specified ColdFusion page or HTML file. For example, you might use CFLOCATION to specify a standard message or response that you use in several different ColdFusion applications. Use the ADDTOKEN attribute to verify client requests.

### Syntax

    <CFLOCATION URL="url" ADDTOKEN="Yes/No">

#### URL

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

#### ADDTOKEN

Optional. Yes or No. CLIENTMANAGEMENT must be enabled (see CFAPPLICATION). A value of Yes appends client variable information to the URL you specify in the URL argument.

### Example

    <!--- This view only example shows the use of CFLOCATION --->
    <HTML>
    <HEAD>
    <TITLE>CFLOCATION Example</TITLE>
    </HEAD>

    <BODY>
    <H3>CFLOCATION Example</H3>
    <P>CFLOCATION redirects the browser to a specified web resource;
    normally, you would use this tag to go to another CF template or to
    an HTML file on the same server.  The ADDTOKEN attribute allows you to
    send client information to the target page.
    <P>The following is example code to direct you back to
    the CFDOCS home page (remove the comments and this information will
    display within the frame):
    <!--- <CFLOCATION URL="../../cfdocs/index.htm" ADDTOKEN="No"> --->

    </BODY>
    </HTML>