Loading
Upcoming Mandatory Changes to Public Key Infrastructure (PKI)Read More
Salesforce Enforces New Security Requirements in Summer 2026Read More
Agentforce and Einstein Generative AI
Table of Contents
Filter by (0)Add
Select Filters

          No results
          No results
          Here are some search tips

          Check the spelling of your keywords.
          Use more general search terms.
          Select fewer filters to broaden your search.

            Search all of Salesforce Help
            Search all of Salesforce Help
            Grounding with Related List Merge Fields

            You are here:

            1. Salesforce Help
            2. Docs
            3. Quickstart Your Einstein Generative AI Solution

            Grounding with Related List Merge Fields

            Ground your prompt templates with your object’s related lists to add depth and context to your grounding.

            Required Editions

            Available in: Lightning Experience
            Available in: Enterprise, Performance, and Unlimited Editions with the Einstein for Platform, or Einstein or Agentforce for Sales or Service add-on, or Agentforce Foundations
            Note
            Note Where possible, we changed noninclusive terms to align with our company value of Equality. We maintained certain terms to avoid any effect on customer implementations.

            With related list support in Prompt Builder you can add related list merge fields in your prompt templates for rich grounding. When you ground a prompt template with a related list, the fields for the related list are based on the page layout of the parent object for the current user. Record-level filters aren’t applied. The retrieved data is rendered in JSON format and shown in the resolution.

            Considerations, Guidelines, and Limitations

            Consider these points when grounding your prompt templates with related lists in Prompt Builder.

            • Activities related lists on objects such as Account and Case aren’t supported.
            • If you configure a related list in a prompt template and a user doesn’t have the related list on their parent object’s page layout or Read permission on the associated object, no related list data is sent to the LLM.
            • Only related lists available on the object’s page layout are available for grounding in Prompt Builder. If an object has custom record types, only related lists on the master record type’s layout are available. If no default record type exists for the context user, the Salesforce default record type is used instead.
            • When entering an expression rather than selecting a resource in the Resource field, an object is shown as {!$RelatedList:Account.Contacts.Records}. After you enter this expression, Prompt Builder simplifies the UI presentation, leaving only Related List: Account.Contacts.
            • In situations where a related list yields zero results, the prompt response still responds successfully but without adding any related list content to the response.
            • The User and Organization related lists aren’t supported due to a limitation involving global variables.

             
            Loading
            Salesforce Help | Article