Skip to main content

Official Support Articles

Search or browse our knowledge base to find answers to your questions ranging from account questions to troubleshooting error messages. The content is curated and updated by our global Support team

Skip the ticket, Chat with Qlik Support instead for instant assistance.

How to handle special characters in the Subject field using Qlik Application Automation Mail Connector

Showing results for 
Search instead for 
Did you mean: 

How to handle special characters in the Subject field using Qlik Application Automation Mail Connector

When sending emails using the Mail Connector in Qlik Application Automation, special characters in the Subject field may not be correctly formatted.


In Qlik Application Automation:

Mail subject.png

Email received:

Mail received.png



The Send Mail block does not have native support for special characters in the Subject input field, but only supports UTF-8 characters.  To use special characters, a Custom Code block can be used with some PHP code to format the text string to be used by the Subject input field.

Do the following:

  1. Create a Custom Code block and place it before the Send Mail block
    Automation flow.png
  2. Select the Custom Code block and make sure Language is set to PHP 7.4
  3. Change one of the default inputs to "Subject" and delete the second default input
  4. Paste the following code into the code block, replacing the example code
    $subject = $inputs['Subject'];
    $subj = addcslashes(mb_encode_mimeheader($subject, "UTF-8", "Q"), '"');
    echo $subj;
  5. Here's the final Custom Code Block
    Custom codeblock no subject.png

  6. Edit the Send Mail block and set Subject input to use the output from the above Custom Code block
    Mail subject input codeblock.png
  7. Open the Custom Code block and enter the text to be used as a subject in the mail being sent
    Custom codeblock subject.png
  8. Run the automation to verify special characters are being correctly formatted in the email subject
    Mail subject correct.png




The information in this article is provided as-is and to be used at own discretion. Depending on tool(s) used, customization(s), and/or other factors ongoing support on the solution below may not be provided by Qlik Support.

Tags (1)
Labels (2)
Partner - Contributor II
Partner - Contributor II


Although I don't have special characters and I have an error with send mail in automation: "Malformed UTF-8 characters, possibly in correctly encoded".

I have tried this solution but I have the same error.

Do you know another reason for this error?



Version history
Last update:
‎2021-11-22 02:11 AM
Updated by: