User Guide
cfmailparam 301
Usage
This tag attaches a file or adds a header to an e-mail message. It can only be used in the cfmail
tag. You can use multiple
cfmailparam tags within a cfmail tag.
You can use this tag to include a file, such as an image, in an HTML mail message. The file can be
displayed inline in an HTML message, or as an attachment. To include multiple files, use
multiple
cfmailparam tags.
To display a file inline in a mail message:
1.
Specify type="html" in the cfmail tag.
2.
Specify disposition="inline" and a ContentID attribute in the cfmailparam tag.
3.
Use a src="cid:ContentIDValue" attribute to identify the content to include in the HTML tag
such as the
img tag.
The second example shows this use.
Examples
<h3>cfmailparam Examples</h3>
<p>This view-only example uses cfmailparam to 1) add header to a message and 2)
attach files and 3) to return a receipt to the sender.</p>
<cfmail from = "peter@domain.com" To = "paul@domain.com"
Subject = "See Important Attachments and Reply">
<cfmailparam name = "Importance" value = "High">
Please review the new logo. Tell us what you think.
<cfmailparam file = "c:\work\readme.txt" type="text/plain">
<cfmailparam file = "c:\work\logo.gif" type="image/gif">
<cfmailparam name="Disposition-Notification-To" value="peter@domain.com">
type Optional The MIME media type of the file. Not used with the
name attribute. 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/.
value Optional Value of the header. Not used with the
file
attribute.
contentID Optional The Identifier for the attached file. This ID should
be globally unique and is used to identify the file in
an IMG or other tag in the mail body that
references the file content.
disposition Optional attachment How the attached file is to be handled. Can be one
of the following:
• attachment: presents the file as an attachment.
• inline: displays the file contents in the message.
Attribute Req/Opt Default Description