hi @shaped clouds 

You can check this links:

https://www.outsystems.com/forums/discussion/93284/difference-between-list-record-structured-list-and-structured-record-list/

https://www.outsystems.com/forums/discussion/20867/convert-structure-list-to-record-list/

https://www.outsystems.com/forums/discussion/83588/list-and-records/

I hope this helps

Thanks

Hi,

In OutSystems, both Record List and List are used to hold collections of items, but they serve different purposes and have key distinctions based on their usage and structure.

Record List

A Record List is a strongly typed list where each item is a Record of a specific structure (like an Entity or Structure). It is ideal when working with Entities or Structures.

List

It is a generic collection type. It is more flexible but less type-safe compared to Record List. It can be used for primitive types (like Text, Integer) or Structures.

Hi @shaped clouds ,
Record lists are also lists. It will be a list of a specific structure or entity.

Thanks

Hallo @shaped clouds ,

🧾 Record List 

• This is the standard structure returned by Aggregates or SQL Queries i 

• It’s a list of Records, where each Record represents one row of data (like from a database table).

• Commonly used as the Data Source for Table widgets in screens.

• OutSystems Table widgets expect a Record List of a specific Entity or Structure.

✅ Use case:

• Displaying query results in a Table.

• Example: GetUsers.List (result of an Aggregate fetching users).

📄 List  

• this usually refers to a List of a basic data type or a List of a specific Structure.

• If it’s not a Record List, it may require conversion or wrapping to use in UI components like Tables.

• You can't bind a Table widget directly to a simple List (like List or List).

⚠️ Limitation:

• You can’t use List (e.g., List of Text or Integer) directly in a Table.

• You would need to create a Structure with one field and convert the List into a Record List of that Structure.