User Guide

120 Chapter 2: ColdFusion Tags
cferror
Description
Displays a custom HTML page when an error occurs. This lets you maintain a consistent look
and feel among an application’s functional and error pages.
Category
Exception handling tags, Extensibility tags, Application framework tags
Syntax
<cferror
type = "a type"
template = "template_path"
mailTo = "email_address"
exception = "exception_type">
See also
cfrethrow, cfthrow, cftry,
Chapter 14, “Handling Errors” in ColdFusion MX Developer’s
Guide.
History
ColdFusion MX: Deprecated the monitor option of the exception attribute. It might not work,
and might cause an error, in later releases.
Attributes
Attribute Req/Opt Default Description
type Required Type of error that the custom error page handles. The type
also determines how ColdFusion handles the error page. For
more information, see “Specifying a custom error page” in
Chapter 14, “Specifying a custom error page,” in ColdFusion
MX Developer’s Guide.
• exception: an exception of the type specified by the
exception attribute.
• validation: errors recognized by server-side type
validation.
• request: any encountered error.
template Required Relative path to the custom error page. (A ColdFusion page
was formerly called a template.)