---
title: Configuring a Watch List
slug: neurons-for-itsm/admin-user-help/enu/latest/configuring-a-watch-list
createdAt: 2026-07-14T19:16:29.785Z
---

Administrators can enable or disable the **Watch List** feature.  

## Prerequisite

To make a business object available in the **Watch List**, a relationship must exist between the **MyShelfItem** business object and the target business object.

If the relationship does not exist, create it before configuring the Watch List.

## Create a relationship

1. In the Configuration console, click **Build **>** Business Objects**.
2. Click **View All** in the upper-right corner.
3. Open the **MyShelfItem **business object.
4. Click **Relationships** in the top row. 

:::Paragraph{indent="1"}
The **Relationships** list opens.
:::

5. Click **Add New**, and then select the business object you want to configure the relationship with. The **Relationship Details** form opens. Refer to [Adding a Relationship to a Business Object](docId\:SzcP-QyW98hBG7IWLEeU2) for details on configuring the relationship.
6. Ensure that you select **ShelfObjectID **from the drop-down list under **This Business Object**.

   :::hint{type="info"}
   You must make this selection prior to selecting the relationship type in step 8 below.
   :::

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/m0kHdQW1lHED_r5J6O5Md_selectrelationshipbusinessobject.png" alt="Shows the selection of the business object to establish the relationship with" position="flex-start" size="80" initialPath="../../Resources/Images/help-images/select_relationship_business_object.png" githubPath="Content/Resources/Images/help-images/select_relationship_business_object.png" showCaption="false" width="885" height="365" darkWidth="885" darkHeight="365" indent="1"}

7. Select the **Zero to many** option.
8. Click **Add This Relationship** when you have completed the configuration form settings.

## Configure a Watch List

After creating the relationship, continue to configure the watch list by doing the following:

1. In the Configuration console, click **Build **>** Automation Tools **>** Watch Lists** to open the **Watch Lists** workspace.

:::Paragraph{indent="1"}
The application displays the watch list sorted by business object.
:::

2. Click **Add New**.
3. Select a business object from the **Business Object** drop-down list.
4. In the **Object Presentation** field, enter the configuration expression. For example, enter **$((("Change " + ChangeNumber) + ": ") + Subject)**.
5. Click **Save**. 

:::Paragraph{indent="1"}
The new business object appears in the **Watch Lists** workspace.
:::

6. Click **Build **>** Business Objects** to open the **Business Objects** workspace.
7. Select a business object.
8. Click the **Layouts** tab. The **Layouts** page appears.
9. Click a layout. The system displays the Layout Editor.
10. You can view your object in list view or form view. For this example, click **gridView**. The list view editor appears. If **Pin It** does not appear in the toolbar area, you can add it. Refer to [Using the Toolbar Editor](docId\:YhznZa2Q-yF4WjCS3KmDN).

:::Paragraph{indent="2"}
*Change Layout - Pin It Button*
:::

::Image[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/rJyzoWpDaxBJ7GMf5VIVh_change-layout-pin-it.png" alt="Pin it button shown for changing record layout in the list view editor" position="flex-start" size="80" initialPath="../../Resources/Images/help-images/change layout pin it.png" githubPath="Content/Resources/Images/help-images/change layout pin it.png" showCaption="false" width="778" height="476" darkWidth="778" darkHeight="476" indent="1"}

11. On the right side of the window, click **Edit**. The system displays the Toolbar Editor.
12. Click **Edit** :inlineImage[]{src="https://api.archbee.com/api/optimize/parib0MC3hVoUNdfQdnac/yOwMLewyf7Jh4cJ7j1Crw_edit-old.png" alt caption size="10" width="16" height="16"} next to the **Pin It** button. The Toolbar Button Editor appears.
13. Enter the options under the **General** tab.

| Field                 | Description                                                                                                                                                 |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Button Invokes Action | Enables this button to perform an action. Select **Pin It** from the drop-down list.                                                                        |
| Display               | Specifies how the **Pin It** button appears. Select from image and text, image only, or text only.                                                          |
| Image                 | The image to display. Select an image from the drop-down list. The default image is SaasAddToMyShelf.png.                                                   |
| Text                  | The default text to show with the image. Select either default to show the default text with the image, or select custom to enter your own text in the box. |
| Tooltip               | The text to appear when users hover over the button. The default is Pin It.                                                                                 |
| Argument              | Left blank                                                                                                                                                  |

14. Click **Save**. The window closes.
15. Click **Save** again. The Toolbar Editor closes. **Pin It** appears in the toolbar area.
16. Click **Save**. Watch List is added to the toolbar.