> For the complete documentation index, see [llms.txt](https://docs.gradient.works/kb/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.gradient.works/kb/automation-builder-kit-abk/actions/advanced/gwfxbuildrecordmapfromfieldaction.md).

# Build Record Map from Field

Takes a collection of records as `input` and the name of a field and builds a [RecordMap](/kb/automation-builder-kit-abk/models/recordmap.md) where the keys are the values of the specified `keyField`. You can then use [Get Record from Record Map](/kb/automation-builder-kit-abk/actions/advanced/gwfxrecordmapgetaction.md) to get a record based on a key.

To use the [RecordMap](/kb/automation-builder-kit-abk/models/recordmap.md) later in your Flow, make sure to select `Store Output Variables` and assign it to a variable resource with a data type of `Apex-Defined` and an apex class of `GradientWorks__RecordMap`. When creating the resource, **do not** check "Allow multiple values (collection)".

For example, if you specify `input` as a collection of Leads and `keyField` as `Id`, this will generate a [RecordMap](/kb/automation-builder-kit-abk/models/recordmap.md) you can use to look up a Lead based on its `Id`.

## Inputs

| Name     | Required | Type           | Description                                                                                                                                       |
| -------- | -------- | -------------- | ------------------------------------------------------------------------------------------------------------------------------------------------- |
| input    | Yes      | List\<SObject> | A collection of input records to use for creating a [RecordMap](/kb/automation-builder-kit-abk/models/recordmap.md)                               |
| keyField | Yes      | String         | The field on each record containing the value to use for that record's key in the [RecordMap](/kb/automation-builder-kit-abk/models/recordmap.md) |

## Outputs

| Name      | Type                                                            | Description                                                                                                              |
| --------- | --------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| recordMap | [RecordMap](/kb/automation-builder-kit-abk/models/recordmap.md) | Contains records from the `input` collection that can be looked up using key values obtained from each item's `keyField` |