# Mappings

Mappings are generally needed when datasets or `Lists` are assigned to other `Lists` with different properties.

This example maps the result of a query (StadiumTestData\_CitiesSelect) with the properties of `Name` and `CountryCode` to a control that expects `text` and `value` properties.

```javascript
await ~.StadiumTestData_CitiesSelect.Results.mapAsync(async MapItem => ({
	text: MapItem.Name,
	value: MapItem.CountryCode
}))
```

## Mapping Editor

Properties of an incoming `List` of objects can be mapped to `List` properties when names of the properties of the assigned data differ from the `List` `Item Type` properties. For this purpose, select the `Field Mapping` option in the `List` `Value` property dropdown.

![](/files/o73FAz0qPA94qvig0QDF)

The `Mapping Editor` displays information in two columns, the target information on the left and the source on the right.

![](/files/FOvQwgNwlNP41fT5u05V)

The target information column (left) provides the

1. Target List
2. All mappable properties of the Target

The source column (right) provides

1. A dropdown to select the source data `List`
2. Input fields to define the mapping for source List properties. The `MapItem` option in the dropdown represents a `List Item`. Where such an item consists of a known type, the type properties are provided for selection.


---

# 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://docs.stadium.software/features/mappings.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.