*Workflows › Reference › Actions › Account and settings*

# Update custom fields

> Writes the values of an entity's custom fields.

## At a glance

| Property | Value |
| --- | --- |
| Domain | `customFields` |
| Group in the editor | Account and settings › Settings |
| Runs as | The owner of the workflow, with their permissions |
| Permission | Administrators only |
| Destructive | Not declared |

ACTION `customFields.updateEntity`

## Inputs

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `entityType` | enum<string> | Yes |  `item`, `contact`, `space`, `project`, `kit`, `serializedItem`, `vehicle`, `staff`, `service`, `purchaseOrder`, `incident`, `repairTicket`, `opportunity` |
| `entityId` | string | Yes |  |
| `customFields` | object[] | Yes | Array of custom fields to update. |
| `customFields.id` | string | Yes |  |
| `customFields.name` | string | No |  |
| `customFields.value` | json | No | Value of the custom field. |
| `customFields.dataType` | enum<string> | No |  `text`, `multitext`, `dropdown`, `checkbox`, `radio`, `date`, `contact`, `item`, `space`, `staffMember`, `vehicle` |
| `customFields.description` | string | No |  |
| `customFields.metadata` | json | No | Additional metadata of the custom field. |
| `customFields.showOn` | string[] | No | List of documents where the field is shown. It can be quote, proforma, invoice, packing_slip, all. `quote`, `proforma`, `invoice`, `contract`, `packing_slip`, `purchase_order`, `repair_ticket`, `all` |
| `customFields.applyAt` | string[] | No | Platforms where the field applies. It can be order, item, space, contact, project, kit, template, all. `order`, `item`, `space`, `contact`, `project`, `kit`, `orderTemplate`, `repairTicket`, `document`, `serializedItem`, `vehicle`, `staff`, `service`, `purchaseOrder`, `incident`, `opportunity`, `all` |
| `customFields.options` | string[] | No | Options for dropdown fields. |
| `customFields.subscriptionId` | string | No |  |
| `customFields.isActive` | boolean | No |  |
| `customFields.isArchived` | boolean | No |  |
| `customFields.order` | number | No |  |
| `customFields.createdAt` | string | No |  |
| `customFields.updatedAt` | string | No |  |
| `customFields.createdBy` | string | No |  |
| `customFields.updatedBy` | string | No |  |
| `customFields.archivedAt` | string | No |  |
| `customFields.archivedBy` | string | No |  |

## Outputs

| Name | Type | Description |
| --- | --- | --- |
| `success` | boolean |  |
| `entityId` | string |  |
| `updatedFields` | number |  |

---

Canonical URL: https://docs.filmo.io/workflows/reference/actions/customfields-updateentity  
Last updated: 2026-10-25