Loading

Send Salesforce Visualforce Email Templates in the Recipient's Local Language

Publish Date: May 4, 2026
Description

In Salesforce, Visualforce email templates support multi-language sending using Custom Labels. Custom Labels are developer-defined text values that support translations for any language enabled in your Salesforce org. By adding translated Custom Label values and referencing them in your Visualforce email template, you can send emails in the recipient's local language by specifying the target language in the language attribute of the messaging:emailTemplate component.
This is useful when your customer base spans multiple languages and you want to ensure email communications are delivered in each recipient's preferred language without maintaining separate template files for each language.

Resolution

To configure Salesforce Visualforce email templates to send in the recipient's local language using Custom Labels, follow these steps.
Custom Labels are managed in Setup > Custom Labels and support translations for each language enabled in your Salesforce org via the Translation Workbench.

Steps

  1. Create a Custom Label for each sentence or phrase you want to include in your email, and provide a translation for every language in which you want to send emails.
  2. Reference the required Custom Labels in your Visualforce email template using the $Label.LabelName merge field syntax.
  3. Set the language attribute of your messaging:emailTemplate component to the desired language code (for example, language="fr" for French, language="de" for German).

By setting the language attribute, Salesforce resolves all Custom Label references in the template to the translated value for the specified language at send time.

Knowledge Article Number

000385830

 
Loading
Salesforce Help | Article