Contents

cfmailparam

Description

Sets a header or attach a file to an e-mail.

Category

Other

Implemented

Usage Syntax

<cfmailparam  
	[file="String"]
	[name="String"]
	[value="String"]
	[type="String"]
	[disposition="String"]
	[contentid="String"]
 />

[] = Optional attribute

Attributes

Name Type Required Default Description
file String No Attaches the specified file to the message. This attribute is mutually exclusive with the name attribute.
name String No Specifies the name of the header. Header names are case insensitive. This attribute is mutually exclusive with the file attribute.
value String No Indicates the value of the header.
type String No The MIME media type of the part.
disposition String No 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.
contentid String No 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.

Example Usage

<---  Adding some headers: --->
<cfmail from="sender@host"
		to="recipient@host"
		subject="Urgent, please read!"
		type="html"
>
	<cfmailparam name="MIME-Version" value="1.0" />
	<cfmailparam name="X-Priority" value="1" />
	<cfmailparam name="X-MSMail-Priority" value="High" />
	<cfmailparam name="Reply-To" value="reply@host" />
	<p>This message adds 4 headers by using cfmailparam tags.</p>
</cfmail>

<---  Adding an attachment: --->
<cfmail from="sender@host"
		to="recipient@host"
		subject="An attachment for you"
		type="html"
>
	<cfmailparam file="#expandPath('images/logo.gif')#" type="image/gif" />
	<p>This message adds an attachment by using a cfmailparam.</p>
</cfmail>