> For the complete documentation index, see [llms.txt](https://help.smallbuilder.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.smallbuilder.com/smallbuilder-lists/builder-setup-steps/datasource-setup/basic-datasource.md). # Basic DataSource The **Basic DataSource** enables **the integration of data from related objects within Salesforce to be displayed in a single List**. By using a Basic DataSource, users can merge data across related objects, ensuring a comprehensive view of information. The real-time data integration ensures that any updates to the connected objects are automatically reflected, providing users with the most up-to-date data. This feature supports more holistic data views, enabling more informed decision-making.

For example, if the object configured in the List Configurator is Product2, and you want to display the price from the related PricebookEntry object, the Basic DataSource can be used to query matching PricebookEntry records and display the product and price together in the List. {% hint style="info" %} Multiple DataSources can be configured and used simultaneously. {% endhint %} *** ### :small\_orange\_diamond: Steps to Configure Basic DataSource 1\. Click the :heavy\_plus\_sign: button to add a new DataSource.

2\. Search for and select the target object for the DataSource.

3\. Configure the DataSource by enabling **activation**, adding a **description**, setting **conditions** for querying the target object, and **mapping fields** to integrate the DataSource data into the List.

No.	Name	Description	Required
1	Active	Activates the DataSource. If not activated, the DataSource will not function during List configuration.
2	Description	Provides a description of the DataSource for clarity.
3	Conditions	Specifies conditions for querying the target object. Use the Query Wizard to write conditions easily. ⚠️ When using fields from the List’s configured object, use `IN` instead of =. `$Current` refers to the List’s configured object. 🆗 `Product2Id IN {$Current.Id}` ❌ `Product2Id = {$Current.Id}`
4	Action	Performs field mapping to integrate the information retrieved by the DataSource into the List.	✔️

--- # Agent Instructions This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com. ## Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter: ``` GET https://help.smallbuilder.com/smallbuilder-lists/builder-setup-steps/datasource-setup/basic-datasource.md?ask=&goal= ``` `ask` is the immediate question: it should be specific, self-contained, and written in natural language. `goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.