---
schema_version: "1"
id: b770ea6bc0971c7f3887b5e2636d2adfe68e72abb076300e585a8f0acce9d22a
title: Create an Explainability Message Template
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/ind/264-0-0/create_explainability_message_templates.md
canonical_url: https://help.salesforce.com/s/articleView?id=ind.create_explainability_message_templates.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 705258fd6f18c8a9133208fad5e3982729f402f6972d3653f46254d412ef5788
description: Explainability message templates store explanation messages, and can be referenced in an expression set version step to explain the step’s result. You can use expression set message tokens in your message templates as placeholders for expression set version resources. Rule designers can then map the tokens to the resources from the expression set version where the template is used. When the expression set runs, the explanations dynamically show the values of the mapped resources.
products:
  - Industry Solutions
  - Cross Cloud
release: "264"
---
# Create an Explainability Message Template

Explainability message templates store explanation messages, and can be referenced in an expression set version step to explain the step’s result. You can use expression set message tokens in your message templates as placeholders for expression set version resources. Rule designers can then map the tokens to the resources from the expression set version where the template is used. When the expression set runs, the explanations dynamically show the values of the mapped resources.

### Required Editions

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small edition"><colgroup><col></colgroup><tbody><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: Lightning Experience</td></tr><tr class=""><td class="slds-cell-wrap" style="vertical-align:top;">Available in: <strong>Enterprise</strong>, <strong>Unlimited</strong>, and <strong>Developer</strong> Editions for Industries clouds that have Business Rules Engine and Decision Explainer enabled</td></tr></tbody></table>

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small permission">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="colgroup" class="slds-cell-wrap" colspan="2" style="text-align:center;vertical-align:top;" id="d4596e69">User Permissions Needed</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d4596e69 ">To create and modify explainability message templates:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d4596e69 ">Decision Explainer Service Access </td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d4596e69 ">To use explainability message templates in expression set steps:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d4596e69 ">Rule Engine Designer</td>

          </tr>
          <tr class="">
            <td data-label="User Permissions Needed" class="slds-cell-wrap" style="vertical-align:top;" headers="d4596e69 ">To run expression sets that have Decision Explainer enabled:</td>

            <td class="slds-cell-wrap" style="vertical-align:top;" headers="d4596e69 ">Rule Engine Runtime</td>

          </tr>
        </tbody>
      </table>

1. From Setup, in the Quick Find box, enter Explainability Message Template, and then select **Explainability Message Template**.
2. Click **New Explainability Message Template**.
3. Enter a name for the template.
    
    Enter a unique name that begins with a letter and doesn’t contain spaces, special characters, or consecutive underscores.
4. Enter a label for the template.
5. In the Message field, enter a message for a combination of the expression set step type and the result type.
    
    To create a token-based message, enter a token name within {} as a placeholder for an expression set version resource.
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-business_rules_engine-264-0-0-production-enus/b2d6dd5c-c231-428b-abbf-3dd2cd51a11f/images/icon_note.png)
    
    Note A message can include up to five unique tokens.
    
    ![Example of explainability message template that uses tokens.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-business_rules_engine-264-0-0-production-enus/b2d6dd5c-c231-428b-abbf-3dd2cd51a11f/business_rules_engine/images/emt_with_token.png)
    
    Here, Resource1 and Resource2 are tokens. When the template is attached to a Calculation step with the Passed result type in an expression set version, rule designers can map the tokens to resources from the version.
6. Select the result type.
7. Select the expression set step type.
    
    The No Result result type applies only to the Decision Table Lookup and Decision Matrix Lookup step types.
8. Select the usage type.
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-business_rules_engine-264-0-0-production-enus/b2d6dd5c-c231-428b-abbf-3dd2cd51a11f/images/icon_note.png)
    
    Note When rule designers search for the explainability message templates to be added to an expression set version step, they see only the templates that share the expression set’s usage type and the templates that don’t have a usage type.
9. To set the message as default for the expression set step type and result type, select **Default**.
    
    If a default template is available for an expression set version’s step type and result type, the template is automatically selected for the step.
    
    ![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-ind-business_rules_engine-264-0-0-production-enus/b2d6dd5c-c231-428b-abbf-3dd2cd51a11f/images/icon_note.png)
    
    Note One Salesforce instance can have only one default message for a combination of expression set step type and result type.
10. Save your explainability message template.

#### See Also

- [_Salesforce Help_: Show Rule Explanations to Users](https://help.salesforce.com/s/articleView?id=ind.use_decision_explainer_in_expression_sets.htm&release=264.0.0&type=5 "When Decision Explainer is available in your Salesforce org, you can show your users the explanations for expression set version step results. The explanations are stored in explainability message templates that your admin creates and maintains.")
- [_Salesforce Help_: Show Rule Explanations to Users (Example)](https://help.salesforce.com/s/articleView?id=ind.show_rule_explanations_to_external_users_example.htm&release=264.0.0&type=5 "This example shows how you can configure an expression set version to show step-result explanations to external users. The example also shows how to preview the explanations that your users see.")