Change how messages are displayed to the end user

concept australia Updated Mar 12, 2026 1 min read can_i_change_how_messages_are_displayed_to_the_end_user.md
Raw file servicenow.com

Control how messages appear in ServiceNow CPQ.

You can show messages to the end user in different formats.

By default, the messages shown for fields on a layout when messaging rules are fired are shown below the field.

[Omitted image "cpq-messages-below.png"] Alt text: Field showing the default message style

However, you can override this behavior, such as to show an icon which can be hovered over to display the message ("tooltip").

[Omitted image "cpq-messages-tooltip.png"] Alt text: Field showing the tooltip message style

In the layout editor, add {“messageDisplayType”: “<type>”} in the field properties (the gear icon) of the element where you want to add the custom message display type. Add {"messageDisplayType": "<type>"} to the raw value.

Accepted type values are above, below, popup, and tooltip. The following table provides more information.

Message display type

Supported on fields

Supported on product picker grid

Supported on fields in set grid

Supported on layout components

Description

below

Yes (Default type)

Yes (Default type)

Messages are displayed in a summary container above or below the grid, or as a hover tooltip. You can include an optional indicator on the cell. For more information, see Using sets in layouts

Yes

Messages are displayed below the target.

above

No

No

Yes (Default type)

Messages are displayed above the target.

tooltip

Yes

Yes

Yes

Messages are displayed in a tooltip, visible when hovering the corresponding icon.

popup

Yes

Yes

No

Yes

Messages are displayed within a popup. Once dismissed, the popup won't appear again until additional messages are triggered on the element.

The following image shows a popup message \(`{“messageDisplayType”: “popup”}`\).

[Omitted image "cpq-messages-popup.png"] Alt text: Field showing the popup message style

Search documentation
Search document titles and file paths on the australia branch