Topics   All   Mac OS X (Only)   Windows (Only)   Linux (Only, Not)   iOS (Only, Not)  
Components   Crossplatform Mac & Win   Server   Client   Old   Guides   Examples
New in version: 7.5   8.0   8.1   8.2   8.3   8.4   8.5   9.0   9.1   9.2    Statistic  


Sets the HTML text of the new email.

Component Version macOS Windows Server FileMaker Cloud FileMaker iOS SDK
SendMail 4.3 Yes Yes Yes Yes Yes
MBS( "SendMail.SetHTMLText"; EmailID; Text )   More


Parameter Description Example value
EmailID The email reference number obtained using SendMail.CreateEmail function. $EmailID
Text The HTML text for the email. Will be encoded by the plugin to quoted printable UTF-8. Email::HTMLText


Returns OK or error.


Sets the HTML text of the new email.
See also SendMail.SetPlainText and SendMail.SetRichText.
If you need to encode text yourself to html, you can use the Text.EncodeToHTML function.
You can read html content from file using the Text.ReplaceNewline function.

You can use Text.MergeFields to replace placeholders with values from variables, fields and expressions.


Create email and set content:

Set Variable [$EmailID; Value:MBS("SendMail.CreateEmail")]
Set Variable [$r; Value:MBS("SendMail.SetHTMLText"; $EmailID; $html)]

Sets the text as plain text and as html:

Set Variable [ $r ; Value: MBS("SendMail.SetHTMLText"; $EmailID; "<html><body>" & GetAsCSS(EMail::PlainText) & "</body></html>") ]
Set Variable [ $r ; Value: MBS("SendMail.SetPlainText"; $EmailID; EMail::PlainText) ]

Add inline graphics with placeholder in HTML:

Set Variable [ $EmailID ; Value: MBS("SendMail.CreateEmail") ]
# prepare HTML from field in FileMaker
Set Variable [ $html ; Value: "<html><body>" & GetAsCSS(EMail::PlainText) & "</body></html>" ]
# Replace $$img$$ in text with image.
Set Variable [ $html ; Value: Substitute($html; "$$img$$"; "<img src=\"cid:image1.png\">") ]
Set Variable [ $r ; Value: MBS("SendMail.SetHTMLText"; $EmailID; $html) ]
# now add a container
Set Variable [ $r ; Value: MBS("SendMail.AddAttachmentContainer"; $EmailID; EMail::ImageContainer; EMail::ImageName; "image/png"; "image1.png") ]

See also

Example Databases

Blog Entries

Created 3th September 2014, last changed 15th October 2018

SendMail.SetFrom   -   SendMail.SetInReplyTo

Feedback: Report problem or ask question.

MBS Xojo Plugins