Whatever message this page gives is out now! Go check it out!
cfabort
Last update:
May 18, 2026
Description
Stops the processing of a ColdFusion page at the tag location. ColdFusion returns everything that was processed before the tag. The tag is often used with conditional logic to stop processing a page when a condition occurs.
Category
Syntax
<cfabort
showError = "error message">Note: You can specify this tag's attributes in an attributeCollection whose value is a structure. Specify the structure name in the attributeCollection and use the tag's attribute names as structure keys.
See also
Attributes
Attribute | Req/Opt | Default | Description |
showError | Optional | Error to display, in a standard ColdFusion error page, when tag executes. |
Usage
When you use the cfabort and cferror tags together, the cfabort tag halts processing immediately; the cferror tag redirects output to a specified page. If this tag does not contain a showError attribute value, processing stops when the tag is reached and ColdFusion returns the page contents up to the line that contains the cfabort tag.
When you use this tag with the showError attribute, but do not define an error page using cferror , page processing stops when the cfabort tag is reached. The message in showError displays to the client .When you use this tag with the showError attribute and an error page using cferror , ColdFusion redirects output to the error page specified in the cferror tag.
When you use this tag with the showError attribute, but do not define an error page using cferror , page processing stops when the cfabort tag is reached. The message in showError displays to the client .When you use this tag with the showError attribute and an error page using cferror , ColdFusion redirects output to the error page specified in the cferror tag.
Note: When using cfabort , cflocation , or cfcontent tags, the OnAbort method is invoked instead on OnRequestEnd.
Example
This example shows the use of cfabort to stop processing.
<cftry>
<!--- make a call to a non-existent function --->
<cfset firstName = getFirstName(userId=10)>
<!--- catch any errors --->
<cfcatch type="any">
<!--- dump the error to the browser --->
<cfdump var="#cfcatch#">
<!--- abort further processing --->
<cfabort>
</cfcatch>
</cftry>
We're glad. Tell us how this page helped.
We're sorry. Can you tell us what didn't work for you?
Share additional feedback to help us improve.
0/255
|
