---
sourceDocument: Australia ServiceNow AI Platform user interface
sourceDocumentLink: https://servicenow-prod.fluidtopics.net/r/platform-user-interface

 Release :

    - australia

ft:locale :

    - en-US

ft:publication_title :

    - Australia ServiceNow AI Platform user interface

ft:clusterId :

    - platux

bundleId :

    - platux

workflow :

    - Platform


---

# Embedded Help planning

# Embedded Help planning {#ariaid-title1}

* Release version: Australia
* 
* Updated March 12, 2026
* 
* ![](https://www.servicenow.com/docs/portal-asset/ico-clock) 2 minutes to read

Before writing custom embedded help, plan the content and note the information used in
the Embedded Help form. Careful planning ensures that the topic appears for the right page and
role.

Each UI page can display embedded help, specified in the Page field as
shown in the following example.  
Figure 1. Embedded help topic for the Service Catalog home page

In planning for embedded help topics, consider how the following fields are used and note the
values that you need for your custom topics.

Page
:   Identify and note the UI page name which is found in the URL when the page is displayed as
    shown. If the page name begins with a dollar sign, such as $mid_server_user, include the dollar
    sign in the page name. Before you write an embedded help topic for the page, search for the
    page name to locate a file you can copy.

Modifier
:
    * Normal content appears for any user with the appropriate role who navigates to the page.
    * Setup content appears when the page is accessed from a link in Guided Setup.

    {#embedded-help-planning__ul_umb_yz1_vy}

    Many embedded help topics in the base system are for Guided Setup. You can copy
    Setup content and change the Modifier to
    Normal to quickly provide help for all users.

Qualifier
:   Identify pages you want custom help for that are used in many applications. For
    example the home.do page opens for every Homepage module and for many
    Dashboard modules. The embedded help administrator can use qualifiers to customize content for a common page in the instance.

Role
:   Specify the lowest level role to provide access to this embedded help topic. All roles that contain the role also see the content, unless another topic targeted to their role exists for the same page.

    For example, if you add embedded help content for the itil role that
    describes your business process for entering incidents, the itil_admin role also sees the
    content. If you write a different topic with the itil_admin role, the itil_admin sees that
    content instead of the itil content.

Product
:   Write content only for the Enterprise topic. You can copy an
    Express topic and change this field to
    Enterprise if appropriate.

Version
:   Base system content is typically specified to the current software version. If you are editing the content for a custom application or to provide information relevant to your organization business process, select All.

Domain
:   If your organization uses domain separation and customizes help content, specify the domain
    the content applies to.

ServiceNow Help
:   If the check box is selected, this field indicates a base system topic. You cannot edit a
    base system topic, but you can create a copy to add custom content.

Content
:   You can use the formatting tools to format the content. The following list describes the
    limitations.

    * You cannot include images in embedded help content.
    * To embed video, you must code the video information in the source code \<\<\>\> view. Video content from YouTube and Vimeo are supported.
    * To add a related information link, you must use a full URL, not a relative URL.
    * Best practice is not to use the highlight text tool, as the color may make text unreadable depending on the theme the user has selected.
    * Any changes you make to embedded help are not automatically deployed to another instance.
    * Changes to the embedded help table are not captured in update sets, update_sync=false is set intentionally.
    {#embedded-help-planning__ul_ksm_t3d_yy}
* **[Use qualifiers in Embedded Help](https://servicenow-prod.fluidtopics.net/isr3bCzRJbFatY_8HiNMBQ)**   
  The embedded help administrator can use qualifiers to customize content for a common page in the instance.
* **[Embedded Help roles](https://servicenow-prod.fluidtopics.net/S1iy1hS6zDqLV0XFj~4vqA)**   
  Embedded help content can be targeted to users with a specified role who access the UI page. All roles that contain the role also see the content, unless another topic targeted to their role exists for the same page.
* **[Embedded Help internationalization](https://servicenow-prod.fluidtopics.net/_I8FWoLNsSLAQ_7ncBhQSQ)**   
  Embedded help internationalization provides the ability for you to localize your embedded help content to a variety of languages to meet global user needs. You can write your embedded help content in a language of your choice and decide what languages to display.