1. Home
  2. Actions
  3. Action reference: wpforms_process

do_action( 'wpforms_process', array $fields, array $entry, array $form_data )

Action that fires during form entry processing, after initial field validation has passed.


The wpforms_process action fires towards the end of form entry processing. It runs after all initial form fields have been validated and sanitized.

This hook should be used when the action potentially needs to return an error and halt form processing (see More Information below for details). Examples: verify if a user account exists or validate data for a payment gateway.

Please remember that the form processing can still be halted/prevented after this hooks fires, by other code using the same hook. See the note below about another similar hook that fires after all validation is passed.

An alternate version of this hook is available to easily limit by form ID, wpforms_process_{$form_id}.

Important note: If you are doing processing and do not need validation or need the entry ID, see wpforms_process_complete.


(array) Sanitized entry field values/properties.
(array) Original $_POST global.
(array) Form settings/data.



More Information


Updated on November 9, 2018

Was this article helpful?