Setting Order Notes Notifications

Liferay DXP 2026.Q1+

Users can communicate through orders using the Questions and Answers feature, which by default, requires users to check the order details for updates. Use Order Note notifications to alert Buyers and Order Managers automatically via email or system alerts the moment a new comment is added.

This interaction is powered by the Commerce Order Note, an Unmodifiable System Object that supports communication and automated notifications. Within the system Object, two additional Terms are available to target the correct recipients for your alerts.

To receive notifications when a note is added to an order, you must

• Create a notification template using specific Commerce Order Note terms.

• Leverage Object Actions to trigger automated notifications whenever a new note is added.

Creating Notification Templates

When configuring templates, use Commerce Order Note Terms to identify recipients. The lists are derived from Buyers and Order Managers that have Order Visibility and the active Notification User Scope.

Label	Description	Term
Order Note Recipient Emails	Dynamic list of email addresses for authorized recipients.	[%COMMERCEORDERNOTE_RECIPIENT_EMAILS%]
Order Note Recipient IDs	Dynamic list of unique system IDs for authorized recipients.	[%COMMERCEORDERNOTE_RECIPIENT_IDS%]

Configuring Email Notifications

1. Follow the steps to create Email Notification Templates.

2. In Settings, select Definition of Terms as the Type for Primary Recipients.

3. In Definition of Terms, select Commerce Order Note as the Entity.

4. Locate and copy the Order Note Recipient Emails Term: [%COMMERCEORDERNOTE_RECIPIENT_EMAILS%].

5. Paste the term into the Recipients field.

6. Click Save.

Configuring User Notifications

1. Follow the steps to create User Notification Templates.

2. In Definition of Terms, select Commerce Order Note as the Entity.

3. Locate and copy the Order Note Recipient IDs Term: [%COMMERCEORDERNOTE_RECIPIENT_IDS%].

4. In Settings, select Definition of Terms.

5. Under To, paste the Term.

6. Click Save.

Triggering Automated Notifications

After creating the template, you must define an Object Action for the Commerce Order Note Object to automate the delivery.

1. Open the Global Menu () and navigate to Control Panel → Objects.

2. Select the Commerce Order Note object.

3. Navigate to Actions tab and click New.

4. Fill in the required information in Basic Info:

   • Action Label.
   • Action Name.

5. Navigate to the Action Builder tab.

6. Under When, select On After Add as the trigger.

7. Under Then, select Notification as the action.

8. Choose either an Email or User template.

   

9. Click Save.

Enabling Notifications User Scope

To ensure that notifications are sent only to authorized users within the visibility scope,

1. Open the Global Menu () and navigate to Commerce → Channels.

2. Select the channel’s General tab.

3. Under Orders, enable the Notification User Scope toggle.

When enabled, this ensures that only the user who placed the order receives notifications for responses sent by Order Managers.

Role-Based Notification Scenarios

Note Author	Orders/Notifications Scope	Privacy Setting	Recipient
Buyer	Orders Visibility Scope set to Account	Public/Private	Order Managers
Order Manager	Orders Visibility Scope set to Account	Public	Buyers
Order Manager	Orders Visibility Scope set to Account	Private	Order Creator
Buyer	Orders Visibility Scope set to User	Public/Private	Order Managers
Order Manager	Orders Visibility Scope set to User	Public/Private	Order Creator
Order Manager	Active “Enable Notifications User Scope”	Public/Private	Order Creator

Note

Account Administrators don’t receive notifications by default unless they are explicitly assigned as Order Managers.

Related Topics

• Managing Channels
• Object Types
• Order Information