Embeds references to ColdFusion pages in CFML. You can embed cfinclude
tags recursively. For another way to encapsulate CFML, see cfmodule. (A ColdFusion page was formerly sometimes called a ColdFusion template or a template.)
Flow-control tags, Page processing tags
<cfinclude template = "template_name">
cfcache,
cfflush,
cfheader,
cfhtmlhead,
cfsetting,
cfsilent
New in ColdFusion MX: If you use this tag to include a CFML page whose length is zero bytes, an empty page displays. (In earlier releases, an error message displays.)
Attribute | Req/Opt | Default | Description |
---|---|---|---|
template |
Required |
|
A logical path to a ColdFusion page. |
ColdFusion searches for included files in the following sequence:
<!--- This example shows the use of cfinclude to paste CFML or HTML code into another page dynamically ---> <h4>This example includes the main.htm page from the CFDOCS directory. The images do not display, because they are located in a separate directory. However, the page appears fully rendered within the contents of this page.</h4> <cfinclude template = "/cfdocs/main.htm">