---
schema_version: "1"
id: 6070c819a5db5c32a8f71cdef1bbf8df3415029a81e29c8b532586dfe87de972
title: Configure Receipts
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/commerce/264-0-0/rt_cms_layouts_receipts_config.md
canonical_url: https://help.salesforce.com/s/articleView?id=commerce.rt_cms_layouts_receipts_config.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: ae40d4318a4468e4b654eeac3327520cfb1a88d29537683cdaaad1b7f18a1b19
description: Customize Point of Sale receipt appearance to match your branding and create a consistent customer experience. Control email receipt-sharing options so that you can ensure secure and efficient delivery. Format receipt content to highlight important information and improve readability.
products:
  - Commerce
release: "264"
---
# Configure Receipts

Customize Point of Sale receipt appearance to match your branding and create a consistent customer experience. Control email receipt-sharing options so that you can ensure secure and efficient delivery. Format receipt content to highlight important information and improve readability.

- **Modern POS App Build**: 5.8.2 or above
- **Platform Support**: iPhone & iPad
- **Offline Support**: Yes

The configuration settings mentioned in this article are managed at the merchant account level.

## Hide the Option to Share Receipt by Email

If you would like to not display the option for the store associates to send emailed receipts in the Order Thank You Screen, it can be turned off the Hide the Option to Share Receipt by Email setting.

## Require Printer for Receipts

If you want to tie ‌receipt functionality closely to whether a hardware printer is configured, you can do so in CMS by turning on the Requires Printer for Receipts setting.

## Setting a Logo

1. Go to the **Receipt Configuration** setting in your app config.
2. Click **EDIT** (the pencil icon).
3. Click the image icon to open the media picker.
4. Select the image file you want to use as the header image and then click **SELECT ASSET**.
5. Click the **SET** button at the bottom.
6. Click the **SAVE** button at the top right.

## Receipt Language Localization

To configure receipts in different languages, see [Receipt Localization](https://help.salesforce.com/s/articleView?id=commerce.rt_pos_settings_localize_receipts.htm&release=264.0.0&type=5 "Use Point of Sale (POS) App to localize the content of the paper receipt based on the user’s choice in the order confirmation screen.") for more details.

## Header and Footer Text

The header and footer text on receipts can be customized. The header text is usually a tagline for the store or a slogan. The footer can be a Thank You message.

## Add PS Tags

There are multiple options for configuring tags for text substitution on receipts. Text substitution works by allowing users to format the way data will appear without knowing exactly what that data will be beforehand.

Example: You want to configure the receipt to display the customer name above the address but you don't know what the name is beforehand. To do this, you use `:ps_first_name` and `:ps_last_name` tags. The current order will take the customer's information and format it correctly.

![Example of PS tag set up for header text,](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_layouts_receipts_config_add_ps_tags.png)

## Tag Types

Refer to [Print Tags Configuration](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_layouts_receipts_tags_config_print.htm&release=264.0.0&type=5 "Print tags are placeholder strings that dynamically display data in Point of Sale layouts. Add print tags to native or HTML text overlays to display information such as order totals, customer names, or store details. You can also use print tags in certain app-level settings.") for a comprehensive list of tags supported for receipt customization.

## Printer Settings

You can set the number of characters per line depending on the printer type. This can be helpful to ensure content is positioned correctly within the printout and not running over to other lines.

## Receipt Settings

Point of Sale provides setting that enable formatting and content changes to the receipt beyond text substitution.

<table class="slds-table slds-table_bordered slds-max-medium-table_stacked slds-m-bottom_small ">
          <colgroup>
            <col>
            <col>
          </colgroup>
          <thead class="slds-text-title_caps ">
            <tr class="">
              <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d226019e242">Setting</th>
              <th scope="col" class="slds-cell-wrap" style="vertical-align:top;" id="d226019e245">Description</th>
            </tr>
          </thead>
          <tbody>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">Receipt Lines Keys</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">
                <p>This field takes a comma-separated list of the key names that will be included in the
                  receipt. This is an example of a comma-separated list of all the possible values:
                </p>
                <p>txdate,txtime,pan,cardType,paymentMethod,paymentMethodVariant,posEntryMode,cvmRes,mid,tid,ptid,authCode,txRef,mref,txtype,totalAmount</p>
                <p style="margin-bottom:0;">Leaving this field empty will default to all values shown on the receipt (i.e., the list
                  in the example above).</p>
              </td>

            </tr>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">Show Loyalty Details</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">Shows loyalty details on the receipt, That is, points earned and loyalty
                tiers.</td>

            </tr>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">Show Customer Profile Details In Header</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">Shows the customer profile details in the header (e.g., Name, Address, Email,
                Customer ID, etc.).</td>

            </tr>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">Show Transaction Header</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">Shows the transaction header above the product details section.</td>

            </tr>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">Show 'Card Holder Copy'</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">Shows the message Card Holder Copy above the transaction details. When toggling this
                on, it will reveal a text field to enter the desired message.</td>

            </tr>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">Show Section Separators</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">Shows a divider line between sections of the receipt.</td>

            </tr>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">Show Tender Details Under Total</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">Shows the tender details and amount, e.g., AMEX $439</td>

            </tr>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">Show Receipt Barcode</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">Adds scannable barcode to receipt.</td>

            </tr>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">Show Customer Name</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">Shows the customer's name for the logged-in customer.</td>

            </tr>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">Show Payment Subheader Message</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">Shows a message such as Your Return Policy underneath the transaction totals.</td>

            </tr>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">Show Items In Columns</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">Shows items in three columns: Item Name, Number Of Items, Price.</td>

            </tr>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">Show Receipt with Compact Line Spacing</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">This setting defines whether a receipt line item will be in spaced out or compact
                mode.</td>

            </tr>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">Swap Total and Subtotal Order</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">This setting swaps the position of Total with SubTotal.</td>

            </tr>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">Show Variant Group ID</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">This setting displays the Variant Group ID next to the product line item.</td>

            </tr>
            <tr class="">
              <td data-label="Setting" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e242 ">VAT Included In Subtotal</td>

              <td data-label="Description" class="slds-cell-wrap" style="vertical-align:top;" headers="d226019e245 ">This setting prevents the VAT value from being removed from the subtotal and removes
                the line item on the receipt to display the VAT value.</td>

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

## Receipt Customization for Fulfillment Types/Subtypes

The POS app allows specifying a prefix that will be added at the beginning of each product line item. This allows store associates to quickly identify the fulfillment type of each of the products.

For orders with products that all have the same fulfillment type and subtype, the PSTags `:ps_o_fulfillment_type` and `:ps_o_sub_fulfillment_type` can be configured to show the respective information. Note that these tags do not apply to orders with mixed fulfillment types/subtypes.

![Fulfillment settings showing fulfillment types set for orders and in store.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_cms_layouts_receipts_config_fulfillment_settings.png)

## Receipt Layouts

After configuring and customizing receipts at a fundamental level, you have the opportunity to enhance the receipt further by configuring a [receipt layout](https://help.salesforce.com/s/articleView?id=commerce.rt_cms_layouts_templates_receipt.htm&release=264.0.0&type=5 "Customize Point of Sale receipts to enhance customer experiences. Configure store-level print receipts and use templates for order returns. The Receipt Layout editor allows you to tailor headers, footers, and item details. Understand common challenges and best practices for clear and readable receipts, including managing returns and exchanges."). With the receipt layout, you have the ability to determine what information will be displayed on the receipts, including store details, product information, store associate details, and more. It's important to note that configuring a layout can override app-level settings starting from v7.16.5.