User Guide

190 Chapter 2: ColdFusion Tags
cfimport
Description
You can use the cfimport tag to import either of the following:
• All ColdFusion pages in a directory, as a tag custom tag library.
• A Java Server Page (JSP) tag library. A JSP tag library is a packaged set of tag handlers that
conform to the JSP 1.1 tag extension API.
Category
Application framework tags
Syntax
<cfimport
taglib = "taglib-location"
prefix = "custom">
See also
cfapplication
History
ColdFusion MX: Added this tag.
Attributes
Usage
The following example imports the tags from the directory myCustomTags:
<cfimport
prefix="mytags"
taglib="myCustomTags">
You can import multiple tag libraries using one prefix. If there are duplicate tags in a library, the
first one takes precedence.
Attribute Req/Opt Default Description
taglib Required Tag library URI. The path must be relative to the web root (and
start with /), the current page location, or a directory specified
in the Administrator ColdFusion mappings page.
• A directory in which custom ColdFusion tags are stored. In
this case, all the cfm pages in this directory are treated as
custom tags in a tag library.
• A path to a JAR in a web-application; for example,
"/WEB-INF/lib/sometags.jar"
• A path to a tag library descriptor; for example,
"/sometags.tld"
Note: You must put JSP custom tag libraries in the
/WEB-IN/lib directory. This limitation does not apply to
ColdFusion pages.
prefix Required Prefix by which to access the imported custom CFML tags
JSP tags.
If you import a CFML custom tag directory and specify an
empty value, "", for this attribute, you can call the custom tags
without using a prefix. You must specify and use a prefix for a
JSP tag library.