Checkout Field Editor

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

Installation

  1. Download the .zip file from your WooCommerce account.
  2. Go toWordPress 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

Go to: WooCommerce > Checkout Fields.

Fields

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)

Columns

  • 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+)

Types

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

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

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

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

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

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:

Usage

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: