---
schema_version: "1"
id: 19adb4f8ade50c0db15d766f5768694061b7ad01071b86f23ddce446d71e2c0a
title: Use Loyalty Management Content Blocks in Email Templates and Template-Based Emails
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/xcloud/264-0-0/content_block.md
canonical_url: https://help.salesforce.com/s/articleView?id=xcloud.content_block.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 83d547982b2869116b2241eaa19913335aafea8b878c7101a52b178d37071675
description: Send personalized emails to your loyalty program members by using the Loyalty Management content blocks.
products:
  - Loyalty Management
release: "264"
---
# Use Loyalty Management Content Blocks in Email Templates and Template-Based Emails

Send personalized emails to your loyalty program members by using the Loyalty Management content blocks.

### 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 in <strong>Enterprise</strong>,&nbsp;<strong>Performance</strong>, <strong>Unlimited</strong>, and&nbsp;<strong>Developer</strong> Editions that have Loyalty Management and Marketing Cloud Engagement enabled.</td></tr></tbody></table>

![Note](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-xcloud-loyalty_management-264-0-0-production-enus/0590ce3e-5a09-45ab-8e5e-68f359c35886/images/icon_note.png)

Note Loyalty Management content blocks can’t be used in multi-org Marketing Cloud Engagement instances where the Engagement instance is connected to multiple Salesforce CRM instances.

## Loyalty Management Content Blocks

 
| Content Block | Description |
| --- | --- |
| Loyalty Campaign Promotion | Send emails to inform members about their promotions. |
| Loyalty Tier Upgrade | Send emails to inform members when their tier is upgraded. |
| Loyalty Accrual Transaction | Send emails to inform members about the points they’ve earned for an activity. |
| Loyalty Redemption Transaction | Send emails to inform members about the points they’ve redeemed for an activity. |

You can add Loyalty Management content blocks to your Engagement org by installing the [Loyalty Management Content Blocks package](https://sf-industries.my.salesforce-sites.com/loyaltymanagementcontentblocks). But before you install the package, perform these prerequisites.

## Prerequisites for Using Loyalty Management Content Blocks

Before you complete the prerequisites for each Loyalty Management content block, ensure that you import the data for these objects into Engagement by using [Marketing Cloud Connect](https://help.salesforce.com/s/articleView?id=mktg.mc_co_marketing_cloud_connect.htm&type=5&language=en_US) and [synchronized data extensions](https://help.salesforce.com/s/articleView?id=mktg.mc_cab_creating_and_interacting_with_synchronized_data_sources.htm&type=5&language=en_US):

- User
- Contact

For each Loyalty Management content block, import data into Engagement for some object fields. We also recommend that you import a few object fields for content blocks. The recommended fields are ones that most companies are likely to use in their emails. Depending on your company's requirements, you can also import data for fields that aren't mentioned here,

## Prerequisites for Using Loyalty Campaign Promotion Content Block

- Associate at least one promotion with a campaign.
- Import these object field data into Marketing Cloud Engagement by using [Marketing Cloud Connect](https://help.salesforce.com/s/articleView?id=mktg.mc_co_marketing_cloud_connect.htm&type=5&language=en_US) and [synchronized data extensions](https://help.salesforce.com/s/articleView?id=mktg.mc_cab_creating_and_interacting_with_synchronized_data_sources.htm&type=5&language=en_US):
    
    Marketing Cloud Connect API user must be assigned the Loyalty Management permission set in the Salesforce org. This ensures that the Loyalty Management objects are available to be added as data sources for data extensions in the Engagement org.
    
    <table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
            <colgroup>
              <col style="width:50%">
              <col style="width:50%">
            </colgroup>
            <thead class="slds-text-title_caps ">
              <tr class="">
                <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d63669e193">Object</th>
                <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d63669e195">Fields</th>
              </tr>
            </thead>
            <tbody>
              <tr class="">
                <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e193 ">Promotion</td>
                <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e195 ">
                  <ul>
                    <li>Id</li>
                    <li>Name</li>
                    <li>CampaignId</li>
                  </ul>
                </td>
              </tr>
              <tr class="">
                <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e193 ">Campaign</td>
                <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e195 ">
                  <ul>
                    <li>Id</li>
                    <li>Name</li>
                  </ul>
                </td>
              </tr>
              <tr class="">
                <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e193 ">CampaignMember</td>
                <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e195 ">
                  <ul>
                    <li>Id</li>
                    <li>ContactId</li>
                  </ul>
                </td>
              </tr>
            </tbody>
          </table>

## Prerequisites for Using Loyalty Tier Upgrade Content Block

Import these object field data into Marketing Cloud Engagement by using Marketing Cloud Connect and synchronized data extensions:

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d63669e250">Object</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d63669e253">Fields</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e250 ">LoyaltyTierBenefit</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e253 ">
              <ul>
                <li>LoyaltyTierId</li>

                <li>BenefitId</li>

                <li>Name</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e250 ">LoyaltyProgram</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e253 ">
              <ul>
                <li>Id</li>

                <li>Name</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e250 ">LoyaltyTier</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e253 ">
              <ul>
                <li>Id</li>

                <li>Name</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e250 ">LoyaltyTierGroup</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e253 ">
              <ul>
                <li>Id</li>

                <li>Name</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e250 ">VoucherDefinition</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e253 ">
              <ul>
                <li>Id</li>

                <li>Name</li>

                <li>Description</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e250 ">Contact</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e253 ">Id</td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e250 ">LoyaltyMemberCurrency</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e253 ">
              <ul>
                <li>Id</li>

                <li>LoyaltyProgramCurrencyId</li>

                <li>LoyaltyMemberId</li>

                <li>PointsBalance (recommended)</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e250 ">LoyaltyProgramMember</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e253 ">
              <ul>
                <li>Id</li>

                <li>ContactId</li>

                <li>MembershipNumber (recommended)</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e250 ">LoyaltyMemberTier</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e253 ">
              <ul>
                <li>Id</li>

                <li>LoyaltyMemberId</li>

                <li>TierExpirationDate (recommended)</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e250 ">Voucher</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e253 ">
              <ul>
                <li>Id</li>

                <li>LoyaltyProgramMemberId</li>

                <li>TransactionJournalId</li>

                <li>BenefitId</li>

                <li>VoucherDefinitionId</li>

                <li>VoucherCode</li>

                <li>ExpirationDate</li>

                <li>Status</li>

              </ul>
            </td>

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

## Prerequisites for Using Loyalty Accrual Transactions and Loyalty Redemption Transactions Content Blocks

Import these object field data into Marketing Cloud Engagement by using Marketing Cloud Connect and synchronized data extensions:

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
        <colgroup>
          <col style="width:50%">
          <col style="width:50%">
        </colgroup>
        <thead class="slds-text-title_caps ">
          <tr class="">
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d63669e493">Object</th>
            <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d63669e496">Fields</th>
          </tr>
        </thead>
        <tbody>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">Contact</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">Id</td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">LoyaltyProgramMember</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>ContactId</li>

                <li>MembershipNumber</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">LoyaltyMemberCurrency</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>LoyaltyProgramCurrencyId</li>

                <li>LoyaltyMemberId</li>

                <li>PointsBalance (recommended)</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">LoyaltyProgramCurrency</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>Name</li>

                <li>CurrencyType</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">LoyaltyLedger</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>TransactionJournalId</li>

                <li>EventType</li>

                <li>Points</li>

                <li>LoyaltyProgramCurrencyId</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">TransactionJournal</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>VoucherCode</li>

                <li>MemberId</li>

                <li>JournalTypeId</li>

                <li>LoyaltyProgramId</li>

                <li>Status</li>

                <li>OrderId (recommended)</li>

                <li>ProductId (recommended)</li>

                <li>ProductCategoryId (recommended)</li>

                <li>PartnerId (recommended)</li>

                <li>UnitOfMeasure (recommended)</li>

                <li>ReferredMemberId (recommended)</li>

                <li>ReferredCorporateMemberId (recommended)</li>

                <li>JournalSubTypeId (recommended)</li>

                <li>PromotionId (recommended)</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">Product2 (optional)</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>Name</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">ProductCategory (optional)</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>Name</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">Partner (optional)</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>Name</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">UnitOfMeasure (optional)</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>Name</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">LoyaltyProgramPartner (optional)</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>Name</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">JournalType (optional)</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>Name</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">JournalSubType (optional)</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>Name</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">VoucherDefinition</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>Name</li>

                <li>Description</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">Order (optional)</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>OrderNumber</li>

              </ul>
            </td>

          </tr>
          <tr class="">
            <td data-label="Object" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e493 ">Voucher</td>

            <td data-label="Fields" class="slds-cell-wrap" style="vertical-align:top;" headers="d63669e496 ">
              <ul>
                <li>Id</li>

                <li>TransactionJournalId</li>

                <li>VoucherDefinitionId</li>

                <li>ExpirationDate</li>

                <li>Status</li>

              </ul>
            </td>

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

## Add the Loyalty Management Content Blocks

To add the Loyalty Management content blocks in your Engagement org, install the [Loyalty Management Content Blocks package](https://help.salesforce.com/s/articleView?id=xcloud.install_the_loyalty_management_package.htm&type=5&language=en_US).

- **[Install the Loyalty Management Content Blocks Package](https://help.salesforce.com/s/articleView?id=xcloud.install_the_loyalty_management_package.htm&release=264.0.0&type=5)**  
    To add Loyalty Management content blocks to your Marketing Cloud Engagement org, install the Loyalty Management Content Blocks package in your Engagement org.
- **[Use Loyalty Management Content Blocks to Create Emails and Email Templates](https://help.salesforce.com/s/articleView?id=xcloud.use_loyalty_content_blocks.htm&release=264.0.0&type=5)**  
    Create emails and email templates that provide members personalized information about their activities.

#### See Also

- [_Salesforce Help_: How to Use the File Transfer Activity in Automation Studio](https://help.salesforce.com/s/articleView?id=mktg.mc_as_using_the_file_transfer_activity.htm&type=5&language=en_US)
- [_Salesforce Help_: Create a Data Extension in Marketing Cloud Engagement](https://help.salesforce.com/s/articleView?id=mktg.mc_es_create_data_extension.htm&type=5&language=en_US)