User Guide

246 Chapter 2: ColdFusion Tags
cfmailparam
Description
Attaches a file or adds a header to an e-mail message. Can only be used in the cfmail tag. You can
use more than one
cfmailparam tag within a cfmail tag.
Category
Forms tags, Internet Protocol tags
Syntax
<cfmail
to = "recipient"
subject = "msg_subject"
from = "sender"
...more attributes... >
<cfmailparam
file = "file-name"
type ="media type">
or
<cfmailparam
name = "header-name"
value = "header-value" >
...
</cfmail>
See also
cfmail, cfmailpart, cfftp, cfhttp, cfldap, cfpop
History
ColdFusion MX 6.1: Added the type attribute.
Attributes
Example
<h3>cfmailparam Example</h3>
<p>This view-only example uses cfmailparam to attach files and add header to
a message.</p>
<cfmail from = "[e-mail]" To = "[e-mail]"
Subject = "See Important Attachments and Reply">
Attribute Req/Opt Default Description
file Required if you do not
specify
name attribute
Attaches file to a message. Mutually exclusive with
name
attribute. The file is MIME encoded before sending.
type Optional The MIME media type of the part. Can be a valid MIME
media type or one of the following:
• text specifies text/plain type
• plain specifies text/plain type
• html specifies text/html type
Note: For a list of all registered MIME media types,
see www.iana.org/assignments/media-types/
name Required if you do not
specify
file attribute
Name of header. Case-insensitive. Mutually exclusive
with file attribute.
value Optional Value of the header.