---
url: "https://vueda.dev/v3/reference/api/js/utils/fieldMappings/functions/mergeDefaultFieldMappings.md"
title: "mergeDefaultFieldMappings"
---

# mergeDefaultFieldMappings

## Overview

Merge custom field mappings into the default set used for forms.

## Signature

`mergeDefaultFieldMappings(customMappings)`

### Parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| <span id="param-customMappings">customMappings</span> | `object` | yes | Additional mappings keyed by field type. |

### Returns

`The updated default field mappings.`

## Examples

```js
import MyCustomField from '@/components/MyCustomField.vue';
import MyCustomWidget from '@/components/MyCustomWidget.vue';

mergeDefaultFieldMappings({
    MyCustomField: {
        MyCustomField: { component: MyCustomField, widget: MyCustomWidget, default: true },
    },
});
```

## Source

`client/lib/utils/fieldMappings.js:788`