How do I use WPForms's Update Field ability with AI?

Install the Easy MCP AI WordPress plugin alongside WPForms, connect your AI client, then ask in natural language — for example: "Make the 'Email' field on form 42 required."

Update Field is a WordPress ability from WPForms — usable via Easy MCP AI, which connects Claude, ChatGPT, and any AI assistant to your site.

Install Free Plugin →

Update Field

Write

WPForms Forms wpforms/update-field

Update properties of an existing field on a WPForms form.

Requires the WPForms plugin on WordPress 6.9+ (abilities only register when the wp_register_ability() function exists). Read abilities need the WPForms 'view_forms' or 'view_form_single' capability. The four write abilities (create-form, update-form-settings, add-field, update-field) additionally require the 'Enable MCP Write Access' toggle (the ai-mcp-write-enabled setting under WPForms → Tools → AI MCP) to be turned on, plus the 'create_forms' or 'edit_form_single' capability — without both, they return a 403 error and are hidden from MCP clients entirely.

What it does

This ability updates one or more properties (label, description, required, size, choices, etc.) of an existing field, identified by form_id and field_id. Properties are validated against the curated set allowed for that field's type; unsupported or unknown keys are not applied and are reported back in an ignored array alongside the updated array of keys that did change. Pairing this with describe-editing-schema lets an AI assistant know in advance which properties a given field type accepts before attempting an update. Requires 'Enable MCP Write Access' to be turned on.

See it in action

You ask your AI assistant

"Make the 'Email' field on form 42 required."

Inputs

Name	Type	Required	Description
form_id	integer	Yes	The ID of the form containing the field.
field_id	integer	Yes	The ID of the field to update.
label	string	No	The field's label, if supported by the field's type.
description	string	No	The field's description text, if supported by the field's type.
required	boolean	No	Whether the field is required, if supported by the field's type.
size	string	No	Field width: small, medium, or large, if supported by the field's type.
label_hide	boolean	No	Whether to hide the field label, if supported by the field's type.
placeholder	string	No	Placeholder text, if supported by the field's type.
default_value	string	No	Default value, if supported by the field's type.
input_columns	string	No	Layout of choice inputs ('', inline, '2', or '3'), for choice-based field types.
choices	array	No	Array of { label, value } choice objects, for choice-based field types.
style	string	No	classic or modern rendering style, for supported field types.
extensions	string	No	Comma-separated list of allowed file extensions, for the Pro-only file-upload type.
max_size	integer	No	Per-file maximum upload size in megabytes, for the Pro-only file-upload type.
max_file_number	integer	No	Maximum number of files uploadable via the modern uploader, for the Pro-only file-upload type.
media_library	boolean	No	Whether to also store uploads in the WordPress Media Library, for the Pro-only file-upload type.

Returns

An object with the form_id, field_id, an updated array of the property keys that were changed, and an ignored array of keys that were not recognized or applied.

Permission

The current user must have the WPForms 'edit_form_single' capability for the given form_id, and the site's 'Enable MCP Write Access' setting must be turned on; otherwise a 403 WP_Error is returned.