---
sourceDocument: Brazil Sales Customer Relationship Management
sourceDocumentLink: https://www.servicenow.com/docs/r/order-management

 Release :

    - brazil

ft:locale :

    - en-US

ft:publication_title :

    - Brazil Sales Customer Relationship Management

ft:clusterId :

    - omgmt

bundleId :

    - omgmt

workflow :

    - Customer and Industry


---

# Configure help popups for layouts

# Configure help popups for layouts {#ariaid-title1}

Release version: Brazil  
Updated March 12, 2026  
![](https://www.servicenow.com/docs/portal-asset/ico-clock) 1 minute to read  
Implement buyside help popups in ServiceNow CPQ.

Help popups give the user more information about a field in a layout. They resemble the tooltip message display type, but differ in the following ways:

* Tool tips appear only when the condition of a message rule is met, whereas help popups are always present on the layout
* Tool tips display only plain text, whereas help popups can include hyperlinks, lists, italics, bold text, newlines, images, and dynamic text
* Tool tips appear on hover, whereas help popup icons must be clicked to display messages

{#cpq-help-message-popups__ul_jks_rjx_g3c}  
Note:  
To learn how to display a message that appears as the result of a message rule, see [Change how messages are displayed to the end user](https://www.servicenow.com/docs/ytvAoz5etdaBZft7m0U51g "Control how messages appear in ServiceNow CPQ.").

## Popup appearance {#cpq-help-message-popups__section_gbf_hby_g3c}

The image below shows a popup message that appears when the user clicks its help icon. To illustrate dynamic text in a help popup, the second image shows additional text that appears as the result of a selected picklist option.

To implement a message popup, add a column header called "help" in cell K1 of your CSV layout.

For a tier, columnset, or field, the format for a help popup is as follows:

    {"content":"<help body>","heading":"<help heading>","trigger":{"type":"icon","url":"<image.url>","label": "<Label>"}}

To assign the popup a button instead of an icon, use "type":"button". The button resembles the following: ![Keyboard icon]()

If you don't specify an image URL, a question mark will appear: ![Question mark icon]()

If you don't specify a label, the default value is "Help."

## Formatting the popup contents {#cpq-help-message-popups__section_hdc_gby_g3c}

The following table shows how to control the formatting of the content of a message popup.{#cpq-help-message-popups__table_ozc_4by_g3c__entry__4}

| Formatting option | Syntax | Output | Notes |
|-|-|-|-|
| Bold | Bold text | \[text display in bold\] | Can use underscores instead of asterisks |
| Italic | `Italic text` | \[text displays in italics\] | Can use underscore instead of asterisk |
| Unordered list | `Item\r- Item\r- Item` | * Item * Item * Item {#cpq-help-message-popups__ul_enl_fcy_g3c} |   |
| Ordered list | `1.Item\r2. Item\r3. Item` | 1. Item 2. Item 3. Item {#cpq-help-message-popups__ol_ilm_dcy_g3c} |   |
| Newline | first line\nsecond line | first line second line |   |
| Link | `[link display text](https://www.google.com)` | \[link display text appears as a clickable link\] | Javascript will be sanitized |
| Image (GIF) | `![alt text](https://www.servicenow.com/docs/image url \"title text\")` |   | Quotes around the title text must be escaped |
| Dynamic text | `{{ fieldVariableName }}` |   | Outputs the value of the selected field in the text |
[Table 1. Message popup formatting options]

{#cpq-help-message-popups__table_ozc_4by_g3c}