CRMJettyBack to crmjetty.comContact us
Menu
Docs / Guides

CRMJetty Portal

Works with
Docs / Dynamics 365

Dynamics 365 Customer Portalv6.3.0

Docs / Salesforce

Salesforce Customer Portalv6.3.0

Docs / Business Central

Business Central Portal

Guides / Email and notifications

How to Customize Portal Email Templates

6 min readUpdated
Short answerGo to Settings → Portal Settings → Template Scripting → Email Templates (in Business Central, Settings → Portal Settings → Email Templates). Edit a default template from the … menu, or select Create, choose the Email Action, write the subject and body with the required parameters, set the status to Active and select Save.

The portal sends emails such as registration confirmations, password reset links and one-time passwords (OTPs) from email templates. Each email action comes with a default template that you can edit, or you can create your own template for the action.

Before you start

Email actions

An email action is the event that sends the email. The actions are predefined. You can’t add new actions to the list.

Email action Sent when
Admin User OTP An admin signs in. Sends a one-time password (OTP) to the admin for a secure login.
Approve Portal User An admin approves a portal user. Tells the user their portal access is approved.
Forgot Password A portal user asks to reset their password. Sends a reset link.
Forgot Username A portal user asks for their username. Helps them recover it by email.
Registration A portal user registers. Confirms the registration and gives next steps.
Send Email to Form Respondent A portal user submits an Add form set up to email the respondent. See How to Send Confirmation Emails After Form Submission.
Two Step Verification Two-factor authentication is on. Sends the OTP a portal user enters to sign in.
Verify Portal User Email verification is on. Sends the link a portal user selects to confirm their account.

In a Business Central portal, email templates are under Settings → Portal Settings → Email Templates, and the email actions are separate for customers and vendors: Customer Approve, Vendor Approve, Customer Confirm Email, Vendor Confirm Email, Customer Registration, Vendor Registration, Admin Registration, Forgot Password, Portal Login OTP and Forgot User Name. When you edit a Business Central template, you can’t change its email action or status. See How to Set Up Customers in Business Central Portal and How to Set Up a Business Central Vendor Portal.

Edit a default template

The Email Templates page lists the default templates the portal creates for you.

  1. Go to Settings → Portal Settings → Template Scripting → Email Templates (Business Central: Settings → Portal Settings → Email Templates).
  2. Select the three dots (…) on the template you want to change.
  3. Select Edit. The Edit Email Template page opens.
  4. Change the subject or body. Keep the parameters the email action needs.
  5. Select Save.
Template Scripting → Email Templates list showing the default templates and the … menu with Edit and Delete
Template Scripting → Email Templates list showing the default templates and the … menu with Edit and Delete
Template Scripting → Email Templates list showing the default templates and the … menu with Edit and Delete
Template Scripting → Email Templates list showing the default templates and the … menu with Edit and Delete

Create a new template

  1. Go to Settings → Portal Settings → Template Scripting → Email Templates (Business Central: Settings → Portal Settings → Email Templates).
  2. Select Create. The Create Email Template page opens.
  3. Fill in the fields in the table below.
  4. In Body, write the email and add the parameters listed below the body.
  5. Select Save.
  6. In the pop-up, select OK to activate the template.
Create Email Template page with Name, Subject, Status, Email Action and Body filled in, and the parameters shown below the body
Create Email Template page with Name, Subject, Status, Email Action and Body filled in, and the parameters shown below the body
Create Email Template page with Name, Subject, Status, Email Action and Body filled in, and the parameters shown below the body
Create Email Template page with Name, Subject, Status, Email Action and Body filled in, and the parameters shown below the body
Field What to enter
Name A name that identifies the template and its email action.
Subject The subject line of the email.
Status Active to use the template, or Inactive.
Email Action The action that sends this email. See Email actions.
Body The email content. Use the editor toolbar to format the text.

Important: Only one template is active for each email action. When you activate a new template, the pop-up warns that the old template will become inactive. Selecting OK activates the new template and deactivates the previous one.

Add parameters

Parameters are placeholders that the portal replaces with real values when it sends the email. The parameters you can use depend on the email action, and the editor shows them below the body.

For example, a template for the Approve Portal User action needs these parameters:

Parameter Replaced with
[FULLNAME] The portal user’s first name
[EMAIL] The portal user’s email address
[PORTALNAME] The portal name

Note: Make sure the template includes all mandatory parameters for its email action.

Delete a template

  1. Select the three dots (…) on the template.
  2. Select Delete.

You can delete only inactive templates. To remove the active template for an action, first activate another template for the same action.

Email templates vs notification templates

The Email Templates described here are for the built-in email actions. Emails you send with a trigger, for example when a portal user submits or edits a record, use an Email Notification template under Template Scripting → Notification. See How to Automate Portal Emails with Triggers.

Tip: You can export email templates from one portal instance and import them into another, such as from sandbox to live. Export and import is available on selected plans. See How to Export and Import Portal Configuration and Pricing.

Troubleshooting

The portal still sends the old email: Check that your new template is Active. Only the active template for an email action is sent.

You can’t delete a template: The template is active. Activate another template for the same email action, then delete it.

A value is missing from the email: Check that the body includes the parameter for it, spelled exactly as shown below the body, including the square brackets.

The email doesn’t arrive: See How to Fix Portal Emails That Are Not Sending.

Did this solve it?No, contact support