<cfmailparam>

Can either attach a file or add a header to a message.

It is nested within a [tag-mail] tag.

You can use more than one cfmailparam tag within a cfmail tag.

This tag cannot have a body.

This tag is also supported within <cfscript>

<cfmailparam file=string filename=string name=string value=string type=string disposition=string contentid=string remove=boolean content=any >
Attribute Description
file
string, optional

Attaches the specified file to the message. This attribute is mutually exclusive with the name attribute.

filename
string, optional

file name used for the file attached with the attribute "file", if not set the name of the file itself is used.

name
string, optional

Specifies the name of the header. Header names are case insensitive. This attribute is mutually exclusive with the file attribute.

value
string, optional

Indicates the value of the header.

type
string, optional

The MIME media type of the part.

disposition
string, optional

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, 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.

remove
boolean, optional

remove attachment from filesystem after the mail is successfully sent

content
any, optional

send given value as attachment

Examples

Simple example for cfmailparam

<cftry>
	<cfmail from="sender@example.com" to="receiver@example.com" subject="mailparam example" server="smtp.gmail.com">
		<cfmailparam name="header" value="Mail header">
		Mailparam header example
	</cfmail>
	<cfcatch>
		<cfdump var="#cfcatch.message#" />
	</cfcatch>
</cftry>

See also