Product documentation Docs
    • English
    • Deutsch
    • 日本語
    • 한국어
    • Français
  • More Sites
    • Now Community
    • Developer Site
    • Knowledge Base
    • Product Information
    • ServiceNow.com
    • Training
    • Customer Success Center
    • ServiceNow Support Videos
  • Log in

Product documentation

  • Home
How search works:
  • Punctuation and capital letters are ignored
  • Special characters like underscores (_) are removed
  • Known synonyms are applied
  • The most relevant topics (based on weighting and matching to search terms) are listed first in search results
Topics are ranked in search results by how closely they match your search terms
  • A match on the entire phrase you typed
  • A match on part of the phrase you typed
  • A match on ALL of the terms in the phrase you typed
  • A match on ANY of the terms in the phrase you typed

Note: Matches in titles are always highly ranked.

  • Release version
    Table of Contents
    • Now Platform capabilities
Table of Contents
Choose your release version
    Home Orlando Now Platform Capabilities Now Platform capabilities Agent Workspace Setting up workspace Set up Record View in workspace Set up the Related Items menu in workspace Create a related list

    Create a related list

    • Save as PDF Selected topic Topic & subtopics All topics in contents
    • Unsubscribe Log in to subscribe to topics and get notified when content changes.
    • Share this page

    Create a related list

    Create a related list to provide agents with information related to an open record automatically.

    Before you begin

    Role required: admin

    About this task

    Related lists appear as tabs above the Form pane.

    Related lists

    Procedure

    1. Navigate to Workspace Experience > Actions & Components > Related List Actions and click New.
    2. On the form, fill in the fields.
      Table 1. Action Assignment form
      Field Description
      Action label Name of the component you're adding as a related list.
      Action name Name that describes what you're adding.
      Implemented as
      • UI component—Displays an icon in a field, form, list, or related list to perform a function, such as adding an attachment to a record, adding a component in the contextual side panel, displaying a form for users to fill out, or searching for a record.
      • Client action—Takes action on the client side, such as dialing a phone number, opening a record, or opening a form to edit a record. There are a preset number of client actions, such as call number, remove notification, and show notifications. You cannot create new ones. Use this option, for example, with a phone number field to enable the agent to dial a phone number by clicking the icon. The client actions that come with Agent Workspace have handlers in the browser that carry out the actions.
      • Server script—Executes a script on the server, for example, to assign a record to someone, or delete a record. Use this option whenever your action involves changing the database.
      Specify UI component Shown only when Implemented as is UI component. Click the magnifying glass icon (Magnifying glass icon) and select the component to add as a related list.
      Specify client action Shown only when Implemented as is Client action. Click the magnifying glass icon (Magnifying glass icon) and select the client action to add as a related list.
      Icon Icon to use in the Related Items section that agents click to use this component.
      Tooltip Text that displays when and agent hovers a mouse over the icon.
      Description Short description of this component.
      Application Application that this component applies to. Global means that the component applies to all applications.
      Workspace Workspace this component belongs in, for example, Agent Workspace, ITSM, CSM, and so forth.
      Table Table this component is tied to. When a record from this table is open, this component can appear as a related list.
      View A set of visual configurations. This value is typically Workspace.
      Active Toggle to make this component active as a related list.
      Order An integer that governs the placement of this icon in the list of related lists. The lower the number, the higher in the list. The typical practice is to make these numbers hundreds, for example, 100, 200, 300, and 400, so you can put new icons between existing ones in the future.
    3. In the related lists, click Advanced view.
    4. (Optional) On the Conditions tab, use the condition builder to create filters that prevent the component's icon from appearing in the related lists.
    5. (Optional) If Implemented as is Server Script, on the Server Script tab, add the server script.
    6. (Optional) On the Confirmations Settings tab, select the Confirmation Required check box if you want to display a pop up that asks the agent to confirm the use of this component.
    7. (Optional) On the Action Exclusion tab, click New to exclude children table from inheriting this component as a related list, or from this table inheriting components from a parent table.
      1. On the form, fill in the fields.
        Table 2. Action Exclusion form
        Field Description
        Action assignment Click the magnifying glass icon (Magnifying glass icon) and select an action assignment, which specifies the
        Table Table associated with this component. Every time Agent Workspace opens a record from this table, this component's icon appears in the Related Items list.
        Exclude this table Toggle to prevent this Table from inheriting this component from its parent table.
        Exclude all child tables Toggle to prevent child tables of Table from inheriting this component in the list of Related Items.
      2. Click Submit.
    8. Click Update.

    What to do next

    Click a component to set it up.
    • Tabs
    • Notifications
    • Form Header
    • UI Actions
    • Ribbon
    • Related Items Menu
    • Form pane
    • Actions & Components
    • Activity Stream
    • Contextual Side Panel

    Record view

    Tags:

    Feedback
    On this page

    Previous topic

    Next topic

    • Contact Us
    • Careers
    • Terms of Use
    • Privacy Statement
    • Sitemap
    • © ServiceNow. All rights reserved.

    Release version
    Choose your release version

      Create a related list

      • Save as PDF Selected topic Topic & subtopics All topics in contents
      • Unsubscribe Log in to subscribe to topics and get notified when content changes.
      • Share this page

      Create a related list

      Create a related list to provide agents with information related to an open record automatically.

      Before you begin

      Role required: admin

      About this task

      Related lists appear as tabs above the Form pane.

      Related lists

      Procedure

      1. Navigate to Workspace Experience > Actions & Components > Related List Actions and click New.
      2. On the form, fill in the fields.
        Table 1. Action Assignment form
        Field Description
        Action label Name of the component you're adding as a related list.
        Action name Name that describes what you're adding.
        Implemented as
        • UI component—Displays an icon in a field, form, list, or related list to perform a function, such as adding an attachment to a record, adding a component in the contextual side panel, displaying a form for users to fill out, or searching for a record.
        • Client action—Takes action on the client side, such as dialing a phone number, opening a record, or opening a form to edit a record. There are a preset number of client actions, such as call number, remove notification, and show notifications. You cannot create new ones. Use this option, for example, with a phone number field to enable the agent to dial a phone number by clicking the icon. The client actions that come with Agent Workspace have handlers in the browser that carry out the actions.
        • Server script—Executes a script on the server, for example, to assign a record to someone, or delete a record. Use this option whenever your action involves changing the database.
        Specify UI component Shown only when Implemented as is UI component. Click the magnifying glass icon (Magnifying glass icon) and select the component to add as a related list.
        Specify client action Shown only when Implemented as is Client action. Click the magnifying glass icon (Magnifying glass icon) and select the client action to add as a related list.
        Icon Icon to use in the Related Items section that agents click to use this component.
        Tooltip Text that displays when and agent hovers a mouse over the icon.
        Description Short description of this component.
        Application Application that this component applies to. Global means that the component applies to all applications.
        Workspace Workspace this component belongs in, for example, Agent Workspace, ITSM, CSM, and so forth.
        Table Table this component is tied to. When a record from this table is open, this component can appear as a related list.
        View A set of visual configurations. This value is typically Workspace.
        Active Toggle to make this component active as a related list.
        Order An integer that governs the placement of this icon in the list of related lists. The lower the number, the higher in the list. The typical practice is to make these numbers hundreds, for example, 100, 200, 300, and 400, so you can put new icons between existing ones in the future.
      3. In the related lists, click Advanced view.
      4. (Optional) On the Conditions tab, use the condition builder to create filters that prevent the component's icon from appearing in the related lists.
      5. (Optional) If Implemented as is Server Script, on the Server Script tab, add the server script.
      6. (Optional) On the Confirmations Settings tab, select the Confirmation Required check box if you want to display a pop up that asks the agent to confirm the use of this component.
      7. (Optional) On the Action Exclusion tab, click New to exclude children table from inheriting this component as a related list, or from this table inheriting components from a parent table.
        1. On the form, fill in the fields.
          Table 2. Action Exclusion form
          Field Description
          Action assignment Click the magnifying glass icon (Magnifying glass icon) and select an action assignment, which specifies the
          Table Table associated with this component. Every time Agent Workspace opens a record from this table, this component's icon appears in the Related Items list.
          Exclude this table Toggle to prevent this Table from inheriting this component from its parent table.
          Exclude all child tables Toggle to prevent child tables of Table from inheriting this component in the list of Related Items.
        2. Click Submit.
      8. Click Update.

      What to do next

      Click a component to set it up.
      • Tabs
      • Notifications
      • Form Header
      • UI Actions
      • Ribbon
      • Related Items Menu
      • Form pane
      • Actions & Components
      • Activity Stream
      • Contextual Side Panel

      Record view

      Tags:

      Feedback

          Share this page

          Got it! Feel free to add a comment
          To share your product suggestions, visit the Idea Portal.
          Please let us know how to improve this content

          Check any that apply

          To share your product suggestions, visit the Idea Portal.
          Confirm

          We were unable to find "Coaching" in Jakarta. Would you like to search instead?

          No Yes
          • Contact Us
          • Careers
          • Terms of Use
          • Privacy Statement
          • Sitemap
          • © ServiceNow. All rights reserved.

          Subscribe Subscribed Unsubscribe Last updated: Tags: January February March April May June July August September October November December No Results Found Versions Search preferences successfully updated My release version successfully updated My release version successfully deleted An error has occurred. Please try again later. You have been unsubscribed from all topics. You are now subscribed to and will receive notifications if any changes are made to this page. You have been unsubscribed from this content Thank you for your feedback. Form temporarily unavailable. Please try again or contact  docfeedback@servicenow.com  to submit your comments. The topic you requested does not exist in the release. You were redirected to a related topic instead. The available release versions for this topic are listed There is no specific version for this documentation. Explore products Click to go to the page. Release notes and upgrades Click to open the dropdown menu. Delete Remove No selected version Reset This field is required You are already subscribed to this topic Attach screenshot The file you uploaded exceeds the allowed file size of 20MB. Please try again with a smaller file. Please complete the reCAPTCHA step to attach a screenshot
          Log in to personalize your search results and subscribe to topics
          No, thanks Login