AttachFile

AttachFile

This function attaches the specified file to the outbound message or displays a link to the file when included in a landing page. This function returns no output.

Arguments

AttachFile(1,2,3,4,5,6,7,8)

NOTE: Arguments 4 – 7 are unavailable in the current release of Marketing Cloud. This should be resolved in a future release.

Files of the following MIME types can be attached to email messages in Marketing Cloud:

NOTE: Marketing Cloud Support must provision this function for use in your account. There is typically an additional charge per attachment sent. Contact your Salesforce Account Executive to complete the process.

NOTE: If the specified file cannot be found at send time, the send will throw a runtime error and abort.

NOTE: If you are attaching an external file and the remote server does not respond within 30 seconds, the send will be scheduled to retry 15 minutes later.

NOTE: Local assets in shared Content Builder or Portfolio locations are not supported.

NOTE: MIME types text/csv, application/xml, text/xml, text/vcard and text/x-vcard have a default content-disposition of attachment, that cannot be overridden.

Example 1

This example attaches a Content Builder asset by Customer/External Key:

%%[

var @customerKey, @fileAlias
set @customerKey = "LoyaltyMembersCB"
set @fileAlias = "LoyaltyMembers_ContentBuilder.zip"

AttachFile("ContentBuilder", @customerKey, @fileAlias)

]%%

Example 2

This example attaches a file from the Marketing Cloud Import folder:

%%[

var @fileName, @fileAlias
set @fileName = "LoyaltyMembers.zip"
set @fileAlias = "LoyaltyMembers_FTP.zip"

AttachFile("FTP", @fileName, @fileAlias)

]%%

Example 3

This example attaches a file from an external website via HTTP/HTTPS:

%%[

var @fileName, @fileAlias
set @fileName = "https://limedash.com/drop/LoyaltyMembers.zip"
set @fileAlias = "LoyaltyMembers.zip"

AttachFile("HTTP", @fileName, @fileAlias)

]%%

Example 4

This example attaches a file from the Portfolio asset by Customer/External Key:

%%[

var @externalKey, @fileAlias
set @externalKey = "LoyaltyMembers"
set @fileAlias = "LoyaltyMembers_Portfolio.zip"

AttachFile("Portfolio", @externalKey, @fileAlias)

]%%