Includes the content from the referenced file (template). The content may be executed as CFML, see compatibility info below. You can embed cfinclude tags recursively. For another way to encapsulate CFML, see cfmodule. (A CFML page was formerly sometimes called a CFML template or a template.)

  <cfinclude template="" runonce="true|false">

 include "template.cfm" runonce=true|false;

Attribute Reference

template string

A logical path to a CFML page.

runonce boolean
Default: false

CF 10+ If set to true, the given template is not processed again for a given request if it has already been processed.



CF9: Added the script syntax: include. CF11: Changed behavior such that only files with the extension cfm or cfml are compiled and executed by cfinclude (configurable in Application.cfc via this.compileextforinclude), all other files will be statically included.

Sample code using the cfinclude tag

CF 9+

include "mypage.cfm";

<cfinclude template="mypage.cfm">

Signup for cfbreak to stay updated on the latest news from the ColdFusion / CFML community. One email, every friday.

Fork me on GitHub