1. Documentation /
  2. Checkout Field Editor

Checkout Field Editor

The Checkout Field Editor provides an interface to add, edit and remove fields shown on your WooCommerce checkout page.


↑ Back to top
  1. Download the .zip file from your WooCommerce account.
  2. Go to: WordPress Admin > Plugins > Add New and Upload Plugin with the file you downloaded with Choose File.
  3. Install Now and Activate the extension.

More information at: Install and Activate Plugins/Extensions.

Setup and Configuration

↑ Back to top

Go to: WooCommerce > Checkout Fields.


↑ Back to top

There are three sets of Fields you can edit:

  • Billing – Payment and billing address section of checkout (payment must be enabled)
  • Shipping – Shipping section of checkout (shipping must be enabled)
  • Additional – Appear after the billing and shipping sections of checkout, next to order notes (order notes must be enabled)


↑ Back to top
  • Name – Name of field, which is used as the meta key to save info. Must be unique.
  • Type – Field type. See ‘Types’ below.
  • Label – Label for input shown in checkout.
  • Placeholder / Option values – Placeholder text for inputs OR the options for select boxes, radios etc. Values should be separated by a pipe (|). Two scenarios are explained below:
    • An options list starting with a pipe creates an empty choice. Used in conjunction with a required select field, it will force the user to choose a valid option.
    • An options list without a pipe as first character will make the first option in the list the default choice whether the field is required or not.
  • Position – Left, right or full width. This applies CSS styling to the box.
  • Validation rules – Choose validation rules to apply: Email, number, and required are supported.
  • Display Options – Options to display fields in Emails (which includes all customer and admin order emails where the address information would be displayed), or Order detail pages (which includes any pages displaying order information, such as the Thank You page and My Account pages on the frontend, and the admin “Edit order” screens). (available in Checkout Field Editor version 1.1.8+)


↑ Back to top

These custom types are supported:

  • Text – standard text input.
  • Password – password text input.
  • Textarea – A textarea field.
  • Select – A dropdown/select box. Requires options set.
  • Multi-select – A multi-select box. Requires options set.
  • Radio – A set of radio inputs. Requires options set.
  • Checkbox – A checkbox field.
  • Date picker – A text field with a JavaScript data picker attached.
  • Heading – Adds a heading to allow separating fields into groups.

Editing core fields

↑ Back to top

In the Billing and Shipping sections, there are core fields highlighted in purple.

Note: Disabling or modifying core fields can cause unexpected results with some plugins; we recommend against whenever possible.

Disabled fields

↑ Back to top

Some core fields have options disabled and cannot be changed:

  • Names of core fields
  • Types of special core fields (country and state)
  • Fields that change dynamically based on the chosen country of a user (address 1, address 2, city, state, postcode) cannot have custom validation rules, e.g. Required fields are determined by locale, not by your settings.

With those limitations in mind, you can:

  • Change the labels and position of the fields.
  • Disable them by ticking the checkboxes per-row and clicking the ‘Disable/Remove’ button. Disabled fields are then greyed out. Use at your own risk.

Re-enable core fields by checking the rows and pressing the ‘enable’ button.

Adding and editing custom fields

↑ Back to top

From the bottom of the fields table:

1. Select the Add Field button.


Once a field is added, a blank row appears.

2. Enter your text and preferences.

3. Save Changes.

Resetting checkout fields

↑ Back to top

To reset your fields back to the original settings:

  1. Go to: WooCommerce > Status > Tools.
  2. Scroll down to Checkout Fields.
  3. Select the Reset Checkout Fields button. Any customizations to your fields will be removed.

Field display and checking values

↑ Back to top

Consider the following date picker field:


In checkout, this is displayed:


After placing an order, the field will be visible in the Admin section ‘Custom Fields’ panel:



↑ Back to top

On the front end, customers can see and enter info in a custom field displayed during checkout. For example, Delivery Date and then use the datepicker to select one:

Or enter text under Food Allergies:



↑ Back to top

How to export custom checkout field data?

↑ Back to top

When you create a custom checkout field, once the data is captured, it is included in your WooCommerce order data.

To export custom checkout field data, you will need to export WooCommerce order data using WooCommerce Customer / Order / Coupon Export.

Here’s how:

  • Go to WooCommerce > Export and select the export type as Orders
  • Click Export

The custom checkout field data is included in your exported order data file!


↑ Back to top

– This snippet does not work with multiple shipping packages. If used, only the first package will be considered.
– The use of webhooks require a functioning WP-Cron.

Use a custom field in the WooCommerce emails

↑ Back to top

You can display your custom fields in emails by using the Display Options column when editing your field. If you are using an older version, or using other custom code/emails you can still use the fields. We have examples of how the fields can be accessed/used via code here: https://woocommerce.com/document/add-a-custom-field-in-an-order-to-the-emails/

Extending the Date Picker Year Range

↑ Back to top

It is possible to extend the year selection range of the date picker fields by placing the following code in your child theme’s “functions.php” file, or in the designated area of your theme’s “functions.php” file:

function custom_adjust_datepicker_range () {
if ( is_checkout() ) {
wp_enqueue_script( 'jquery' );
<script type="text/javascript">
jQuery( document ).ready( function ( e ) {
if ( jQuery( '.checkout-date-picker' ).length ) {
jQuery( '.checkout-date-picker' ).datepicker( 'option', 'changeYear', true );
jQuery( '.checkout-date-picker' ).datepicker( 'option', 'yearRange', '-40:+0' );
} // End custom_adjust_datepicker_range()
add_action( 'wp_footer', 'custom_adjust_datepicker_range', 50 );

This adjusts the year selector of the date picker to expand by 40 years.

Setting a default value for a radio button field

↑ Back to top

It’s possible to set a default value for a radio button checkout field by placing the following code in your child theme’s “functions.php” file, or in the designated area of your theme’s “functions.php” file:

function custom_override_checkout_fields ( $fields ) {
$fields['billing']['test_radio']['default'] = 'one';
return $fields;
} // End custom_override_checkout_fields()
add_filter( 'woocommerce_checkout_fields' , 'custom_override_checkout_fields' );

The above snippet assumes that the field is a “billing” field, that the field name is “test_radio” and that the desired default value is “one.”

Add custom fields to WebHooks API

↑ Back to top
/* WooCommerce – extends woocommerce checkout field editor */
/* adds additional display areas (Admin edit user screen and WooCommerce WebHooks */
* add custom checkout fields to user profile on admin edit screen
* @param mixed $payload
function filter_woocommerce_admin_profile__custom_checkout_fields( $payload ) {
if ( class_exists( 'WC_Checkout_Field_Editor' ) ) {
$fieldgroups = array( 'billing'=>'billing', 'shipping'=>'shipping', 'additional'=>'additional' );
foreach ($fieldgroups as $fieldgroup => $payload_group) {
$fakeorder = new WC_Order();
foreach (wc_get_custom_checkout_fields($fakeorder , array( $fieldgroup ) ) as $field_name => $field_options ) {
//basic validation, is the field enabled
if ( !isset($field_options['enabled'] ) || ( $field_options['enabled'] != true ) )
//is the field for profile
if ( (!isset($field_options['display_options']) ) || ( !is_array($field_options['display_options'])) || ( !in_array('profile', $field_options['display_options'])) )
//passed all checks, add to payload
/*'fields' => array(
'billing_first_name' => array(
'label' => __( 'First name', 'woocommerce' ),
'description' => ''
$payload_value = array(
'label' => $field_options['label'],
'description' => ''
if ($field_options['type'] == 'select') {
$payload_value['type'] = 'select';
$payload_value['options'] = $field_options['options'];
$payload[$payload_group]['fields'][$field_name] = $payload_value;
return $payload;
* filter add for above function
add_filter( 'woocommerce_customer_meta_fields', 'filter_woocommerce_admin_profile__custom_checkout_fields', 10, 1 );
* filter action to add custom checkout fields to the webhook payload
* @param mixed $payload
* @param mixed $resource
* @param mixed $resource_id
* @param mixed $this_id
function filter_woocommerce_webhook_payload__custom_checkout_fields( $payload, $resource, $resource_id, $this_id ) {
if ( class_exists( 'WC_Checkout_Field_Editor' ) ) {
$fieldgroups = array( 'billing'=>'billing_address', 'shipping'=>'shipping_address', 'additional'=>'additional' );
if ($resource != 'order' || empty($resource_id)) {
return $payload;
$order = wc_get_order( $resource_id );
foreach ($fieldgroups as $fieldgroup => $payload_group) {
foreach (wc_get_custom_checkout_fields($order , array( $fieldgroup ) ) as $field_name => $field_options ) {
//basic validation, is the field enabled
if ( !isset($field_options['enabled'] ) || ( $field_options['enabled'] != true ) )
//is the field for webhooks
if ( (!isset($field_options['display_options']) ) || ( !is_array($field_options['display_options'])) || ( !in_array('webhook', $field_options['display_options'])) )
//passed all checks, add to payload
$payload_value = get_post_meta( $resource_id, $field_name, true );
$payload['order'][$payload_group][$field_name] = $payload_value;
if ( is_array($payload['order']) ) {
$payload['order']['customer'][$payload_group][$field_name] = $payload_value;
return $payload;
* filter add for above function
add_filter( 'woocommerce_webhook_payload', 'filter_woocommerce_webhook_payload__custom_checkout_fields', 10, 4 );
* filter action to add "profile" and "webhook" to selectable display options in custom options editing screen
* @param mixed $options
function filter_woocommerce_custom_checkout_display_options__customer_checkout_fields_profile($options) {
$options['profile'] = __( 'Admin Profile', 'woocommerce-checkout-field-editor' );
$options['webhook'] = __( 'Webhooks', 'woocommerce-checkout-field-editor' );
return $options;
* filter add for above function
add_filter ('woocommerce_custom_checkout_display_options', 'filter_woocommerce_custom_checkout_display_options__customer_checkout_fields_profile', 10, 1);

Select Field Placeholder text

↑ Back to top

You can add placeholder text when using the Select field by adding 2 || to separate the placeholder from the option values.
For example:
Placeholder || Option 1 | Option 2 | Option 3
Select field placeholder

Questions and Support

↑ Back to top

Something missing from this documentation? Do you still have questions and need assistance?

  • Have a question before you buy this extension? Please fill out this pre-sales form – please include the name of this extension in your query.
  • Already purchased and need some assistance? Get in touch with a Happiness Engineer via the WooCommerce.com Support page and choose this extension name from the “I need help with” dropdown


The most customizable ecommerce platform for building your online business.

  • 30-day money-back guarantee
  • Support teams across the world
  • Safe and secure online payment