# Data source setup

**DataSource settings allow you to configure an internal or external data source to pass data to the List to display alongside values from the object the List is based on.**

### Adding a data source in the builder screen

Press the 'DataSource Setup' button in the top right corner of the builder screen to go to the DataSource setup screen.

<figure><img src="/files/4NGN0WFWsjq6ktBvqpFG" alt=""><figcaption></figcaption></figure>

<figure><img src="/files/DzpQ0UIMIz9Fkl1EFXtX" alt=""><figcaption><p>DataSource settings screen</p></figcaption></figure>

### DataSource types

### [Internal](/smallbuilder-lists/setup/datasource-setup/internal.md)

Internal DataSources are used when you want to look up related objects in Salesforce to present data together.

For example, if the Lookup object is specified as Product2 and you want to display the unit price from a PricebookEntry, you can use an internal data source to look up the PricebookEntry that meets the criteria, and display the product and unit price together.

### [External](/smallbuilder-lists/setup/datasource-setup/external.md)

External DataSources are mostly used when you want to retrieve data from an external server and display it together with data from the Parent, Line-item or Lookup objects. Since the data is retrieved using a user-created Apex Class, it has the advantage of being able to retrieve data more freely than with internal Salesforce data sources.

For example, if you want to fetch real-time inventory numbers from an external server or ERP system, then you can write Rest API code in an Apex Class and point it to an external data source. Then, you will be able to view that data in the Line-Item Configurator.


---

# Agent Instructions: 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:

```
GET https://help.smallbuilder.com/smallbuilder-lists/setup/datasource-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
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.
