{"id":21420,"date":"2026-07-21T10:14:57","date_gmt":"2026-07-21T10:14:57","guid":{"rendered":"https:\/\/tenthplanet.in\/idempiere\/?p=21420"},"modified":"2026-08-20T07:17:54","modified_gmt":"2026-08-20T07:17:54","slug":"how-to-configure-mail-template-in-idempiere","status":"publish","type":"post","link":"https:\/\/tenthplanet.in\/idempiere\/how-to-configure-mail-template-in-idempiere\/","title":{"rendered":"How to Configure Mail Template in iDempiere"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Mail Template is the iDempiere window that stores reusable email Subject and Mail Text content, in plain text or HTML, for communications.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Businesses use it for product announcements, promotions, and customer reminders, personalizing each email with variables like @Name@ before sending.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">The template itself only defines content; delivery is handled by processes such as Send Mail Text using the Tenant\u2019s SMTP configuration.<\/p>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Process Flow<\/strong><\/h2>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"1024\" height=\"305\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-PartnerRelation-Mail-Template-ProcessFlow.png\" alt=\"TenthPlanet-iDempiere-PartnerRelation-Mail-Template-ProcessFlow\" class=\"wp-image-27790\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-PartnerRelation-Mail-Template-ProcessFlow.png 1024w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-PartnerRelation-Mail-Template-ProcessFlow-300x89.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-PartnerRelation-Mail-Template-ProcessFlow-768x229.png 768w\" sizes=\"auto, (max-width: 1024px) 100vw, 1024px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Business Rules<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>A Mail Template stores the email Subject and Mail Text.<\/li>\n\n\n\n<li>The HTML checkbox determines whether Mail Text is rendered as HTML or plain text.<\/li>\n\n\n\n<li>One Mail Template can be reused to generate emails for multiple recipients.<\/li>\n\n\n\n<li>Variables such as @Name@ are replaced with recipient-specific values during sending.<\/li>\n\n\n\n<li>The Mail Template does not select recipients, connect to SMTP, or deliver emails.<\/li>\n\n\n\n<li>Email delivery depends on the Tenant\u2019s configured SMTP settings.<\/li>\n\n\n\n<li>Every email generated from a template is logged in the User Mail tab.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Prerequisites<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Tenant SMTP configuration completed (Mail Host, Port, Authentication, SSL\/TLS).<\/li>\n\n\n\n<li>Recipient list available, such as Business Partner Contacts or Interest Area subscribers.<\/li>\n\n\n\n<li>HTML content prepared in advance if the template will use HTML formatting.<\/li>\n<\/ul>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Configuration Steps<\/strong><\/h2>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 1: Create the Mail Template Record<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">This establishes a reusable email content record that can be selected by sending processes.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Navigate to Partner Relations \u2192 Marketing \u2192 Mail Template, click New, and enter a Name for the template.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Field<\/strong><\/td><td><strong>Sample Value<\/strong><\/td><td><strong>Purpose<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Name<\/td><td>Product Updates<\/td><td>Identifies the Mail Template for selection<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 2: Enter Subject and Set the HTML Option<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">The Subject defines the email header text, and the HTML checkbox controls whether Mail Text is interpreted as HTML.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Enter the Subject line, then check HTML if the Mail Text will contain HTML-formatted content such as tables and styled text.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Field<\/strong><\/td><td><strong>Sample Value<\/strong><\/td><td><strong>Purpose<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Subject<\/td><td>New Product Features Available<\/td><td>Text shown as the email subject line<\/td><\/tr><tr><td>HTML<\/td><td>Checked<\/td><td>Renders Mail Text as formatted HTML instead of plain text<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 3: Enter Mail Text with Personalization Variables<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Mail Text holds the actual email body and supports variables such as @Name@ for per-recipient personalization.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Enter or paste the HTML or plain text content into Mail Text, placing @Name@ wherever the recipient\u2019s name should appear.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Field<\/strong><\/td><td><strong>Sample Value<\/strong><\/td><td><strong>Purpose<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Mail Text<\/td><td>Dear @Name@, We are pleased to share the latest product updates for POTS Retail ERP&#8230;<\/td><td>Email body content with a personalization variable<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"910\" height=\"704\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-PartnerRelations-MailTemplate.png\" alt=\"TenthPlanet-iDempiere-PartnerRelations-MailTemplate\" class=\"wp-image-21431\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-PartnerRelations-MailTemplate.png 910w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-PartnerRelations-MailTemplate-300x232.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-PartnerRelations-MailTemplate-768x594.png 768w\" sizes=\"auto, (max-width: 910px) 100vw, 910px\" \/><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 4: Save the Template<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Saving makes the template available for use in email-sending processes.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Click Save. The template becomes selectable in Send Mail Text and other standard processes that support Mail Templates.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\"><strong>Step 5: Review the User Mail Tab After Sending<\/strong><\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Every email generated from the template through a sending process, such as Send Mail Text, is logged here for tracking.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Open the User Mail tab under Mail Template to review each recipient\u2019s Message ID, Delivery Confirmation, and Delivered status.<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Field<\/strong><\/td><td><strong>Sample Value<\/strong><\/td><td><strong>Purpose<\/strong><\/td><\/tr><\/thead><tbody><tr><td>User\/Contact<\/td><td>Praveen<\/td><td>Recipient the email was generated for<\/td><\/tr><tr><td>Message ID<\/td><td>&lt;246306575.27.1784625452446@smtp.gmail.com&gt;<\/td><td>Unique identifier assigned by the SMTP server<\/td><\/tr><tr><td>Delivered<\/td><td>No \/ blank<\/td><td>Indicates whether delivery was confirmed by the mail server<\/td><\/tr><tr><td>Delivery Confirmation<\/td><td>Blank until confirmed<\/td><td>Records delivery confirmation details when available<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<figure class=\"wp-block-image size-full\"><img loading=\"lazy\" decoding=\"async\" width=\"910\" height=\"410\" src=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-PartnerRelations-MailTemplate1.png\" alt=\"TenthPlanet-iDempiere-PartnerRelations-MailTemplate-1\" class=\"wp-image-21435\" title=\"\" srcset=\"https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-PartnerRelations-MailTemplate1.png 910w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-PartnerRelations-MailTemplate1-300x135.png 300w, https:\/\/tenthplanet.in\/idempiere\/wp-content\/uploads\/sites\/13\/2026\/07\/TenthPlanet-iDempiere-PartnerRelations-MailTemplate1-768x346.png 768w\" sizes=\"auto, (max-width: 910px) 100vw, 910px\" \/><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Common Issues and Resolutions<\/strong><\/h2>\n\n\n\n<figure class=\"wp-block-table\"><table><thead><tr><td><strong>Issue<\/strong><\/td><td><strong>Cause<\/strong><\/td><td><strong>Resolution<\/strong><\/td><\/tr><\/thead><tbody><tr><td>Email not delivered<\/td><td>SMTP configuration is incorrect<\/td><td>Verify Mail Host, Port, Authentication, and credentials<\/td><\/tr><tr><td>Variables are not replaced<\/td><td>Unsupported or incorrect variable name used<\/td><td>Use supported Mail Template variables such as @Name@<\/td><\/tr><tr><td>HTML formatting is not applied<\/td><td>HTML option is disabled<\/td><td>Enable the HTML checkbox on the template<\/td><\/tr><tr><td>SMTP authentication error<\/td><td>Invalid SMTP username or password<\/td><td>Verify the configured SMTP credentials<\/td><\/tr><tr><td>Email sent without personalization<\/td><td>Recipient context was not set by the calling process<\/td><td>Use a standard process such as Send Mail Text, which personalizes each email<\/td><\/tr><tr><td>Delivered column shows No<\/td><td>Invalid recipient address or username at send time<\/td><td>Correct the recipient\u2019s email address and resend<\/td><\/tr><tr><td>User Mail record missing for a recipient<\/td><td>Recipient was not included in the Send Mail Text run<\/td><td>Re-run Send Mail Text with the correct recipient list<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h2 class=\"wp-block-heading\"><strong>Next Steps<\/strong><\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li>Configure Tenant SMTP settings if not already done.<\/li>\n\n\n\n<li>Create recipient subscriptions or Business Partner contacts for the audience.<\/li>\n\n\n\n<li>Run the Send Mail Text process using this template.<\/li>\n\n\n\n<li>Review the User Mail tab to confirm delivery for each recipient.<\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Mail Template is the iDempiere window that stores reusable email Subject and Mail Text content, in plain text or HTML, [&hellip;]<\/p>\n","protected":false},"author":3,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"footnotes":""},"categories":[10,87],"tags":[],"class_list":["post-21420","post","type-post","status-publish","format-standard","hentry","category-idempiere-product","category-idempiere-partner-relations"],"_links":{"self":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/21420","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/users\/3"}],"replies":[{"embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/comments?post=21420"}],"version-history":[{"count":1,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/21420\/revisions"}],"predecessor-version":[{"id":27791,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/posts\/21420\/revisions\/27791"}],"wp:attachment":[{"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/media?parent=21420"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/categories?post=21420"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/tenthplanet.in\/idempiere\/wp-json\/wp\/v2\/tags?post=21420"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}