---
schema_version: "1"
id: cee0f6a06fbb66dc2865ef4a48e62b9b4bca4ca9d24c8d99c2da395cfc719f4a
title: Create Custom Messages in Point of Sale
collection: admin
version: current
locale: en-us
portal_url: https://docs.salesforce.com/admin/current/en-us/commerce/264-0-0/rt_pos_settings_custom_messages.md
canonical_url: https://help.salesforce.com/s/articleView?id=commerce.rt_pos_settings_custom_messages.htm&release=264.0.0&type=5
source_site: help.salesforce.com
content_type: documentation
content_hash: 5c11489b1c20e6076fdcd6a5b2fe6d29ac0edee3b0632b972692a3aad83adf50
description: Customize messages that appear on different screens based on different events.
products:
  - Commerce
release: "264"
---
# Create Custom Messages in Point of Sale

Customize messages that appear on different screens based on different events.

## Set up Customizing Messages in CMS

By default, the user can see default messages from different groups. The user can then customize those messages using the CMS.

### Create a Customized Message

To create a message:

1. In CMS, go to **Store Management > Custom Messages**.
2. To create a custom message, select **CREATE** in the top right of the screen.
3. Enter a message key and a custom message.
4. Select **Save**.![The Custom Messages screen in Point of Sale CMS, where you can create or edit a ustom message.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_pos_settings_custom_message_cms.png)

### Edit a Custom Message

To edit an existing message:

1. Select the pencil icon to the right of a message.
2. Turn on **Customize Message**.
3. Enter a custom message.
4. Select **Save**.

## Field Mapping Message Key Field Transformation | Custom Messages

Field mappings in CMS include field transformations. For example, using the **To Uppercase** field transformation "transform" the lower case colors to capitalized colors. For example "blue" transform to "BLUE", "red" transform to "RED", and so on.

There are many types of field transformations, one of which includes **Message Key**. With this method, rather than manually entering a custom message, the message instead shows automatically using key-value pairs.

To use the Message Key field transformation:

1. In CMS, go to **Feeds > Field Mappings**.
2. Select the area you'd like to add a custom message.
3. Select the green line associated with a Source Field.
4. Select **Message Key** under **Transformation Type**.
5. Fill in the fields and select **SET**.
6. Select **SAVE** in the top right of the screen. ![The Field Transformations section of Custom Messages in Point of Sale CMS.](https://sf-zdocs-cdn-prod.zoominsoftware.com/tdta-commerce-retail-264-0-0-production-enus/17d647fb-8988-49fb-9add-c4f4cc79c9e4/retail/images/rt_pos_settings_cms_field_transformations.png)

The **Message Key** field transformer has two optional transform parameters: **Message Key Separator** and **Default Message**.

Let's say you have a string of message keys, "`order.failure|promocode.redeem.failure`". Notice that a pipe (|) separates the message keys. This is the **Message Key Separator** because it's separating the many keys in a string. If the message keys are split for each message key, Salesforce looks up an entry (value) for it in the brand's custom messages. If no custom message is found, the message key itself is used as the message. Additionally, if the message key is blank, then the message to be displayed is whatever you entered in the **Default Message** field.

After all messages are retrieved for the given keys, the messages are recombined into a single string with the **Message Key Separator** separating them. This string is what is stored in the target field.

  
| Key | Is it in the system? | Value |
| --- | --- | --- |
| order.failure | Yes | Your order has failed! |
| promocode.redeem.failure | Yes | Your promotion code is invalid! |
| order.partial | No | Order.partial |
| Blank | Not applicable because there's no key | Default message |

A string of message keys:

`"order.failure|promocode.redeem.failure|order.partial| "`

Final result:

`"Your order has failed!|Your promotion code is invalid!|Order.partial| Your order cannot be processed at this time."`