WooCommerce custom fields: how to create and display them [+video]

In this post, I’m going to walk through how to add WooCommerce custom fields to a product. We’ll look at two types of custom fields:

  1. Fields that present additional information about the product
    First, we’ll look at WooCommerce extra product data fields – custom fields that display additional information for your products.
  2. Fields that allow the user to customise the product
    Second, we’ll look at custom input fields (also called product add-ons) like text fields, select fields, checkboxes, and so on that allow the user to enter additional, personalised information about a product

We’ll also take a look at how you can use both types of custom field in combination, displaying extra product data depending on certain user choices.

The primary way to add custom fields (and by far the easiest way) is to use a plugin. The process is really simple and doesn’t require any programming knowledge. You don’t even need to use shortcodes.

(As an optional extra, we’ll also look at how to add custom fields programmatically to WooCommerce at the end of the article. But this is definitely optional.)

Plus, we’ll take a look at Advanced Custom Fields and how to add custom fields to the checkout.

This is a long post but it’s likely you won’t need to read it all. Use the navigation menu to the left or the links within the post to help you navigate around.

Examples of both types of WooCommerce custom fields

Let’s take a quick look at both types of custom fields so we understand the difference.

1. Extra product data custom fields

The highlighted area in the example below shows extra product data fields that display additional information for a product.

You can see in this example that there’s no user input – it’s simply additional content.

2. Custom add-ons fields

The second example below shows a product page for a jewellery website. You can see that there are a number of extra fields, like ‘Add a personalized message’ and ‘Gift wrap this item’ where the user can enter their own information and make certain choices about the product they want. This is an example of the add-ons type custom field.

This is the difference between the two types of custom fields: add-ons allow the user to enter information about the product; data fields simply present information about the product.

What is the difference between custom fields and attributes?

Using product attributes and variations, you add the description, the price, and the attributes, which will be the same for every customer.

With custom fields, the product is potentially different for every customer. If you are selling bracelets that can be engraved with a name, then each customer will be entering their own name. You can’t create attributes for that.

You can check out this article, if you’d like to learn more specifically about adding custom fields to variations.

The easiest way to add custom fields to WooCommerce

By far the easiest way to add WooCommerce custom fields is to use the Product Add-Ons Ultimate plugin. This will allow you to add any type of custom field to WooCommerce products in a simple and straightforward way.

This plugin is used by all kinds of businesses to improve their customer experience and optimize sales. The order processing team at Ella’s Bubbles, for example, was able to save thousands of hours by using this plugin for product add-ons. Similarly, the Bonbon Boys saw a huge spike in gift card sales after using this plugin to add upsells.

You can download the plugin by clicking the image below.

WooCommerce Product Add-Ons Ultimate featured image

WooCommerce Product Add-Ons Ultimate

Personalize products with extra fields and custom options

Find Out More

How to display extra product information in WooCommerce using data fields

Okay, so we said there were two types of WooCommerce custom fields. The first type is used to display extra information about the product to the user.

Let’s have another look at the screenshot from the start of the article. Or you could view the actual working demo here.

WooCommerce custom fields displaying extra product information

Here you can see that we’ve presented the user with some further information about the product.

A couple of things to note about these extra fields:

  • They’re nicely formatted in a simple table making them easy to read and meaning that you don’t need to add any of your own styles
  • Each piece of data can have its own row
  • You can include an icon or an image with each piece of data (this is optional)
  • You can include a title or a label, e.g. ‘Cache’, then further details, e.g. ‘4MB Smart Cache’

There’s a detailed tutorial on displaying additional information on WooCommerce products here.

What can you use custom data fields for in WooCommerce products?

The example above uses custom data fields to display technical information about a product. But you can use custom product data fields for all kinds of purposes, including:

  • Technical specifications
  • Nutritional information for food products, e.g. calorie content, fat content
  • Additional notes about pricing
  • Information about shipping or lead times
  • Product data that works best in a table format
  • Custom pricing information

We’ll take a look at some of these examples shortly. But first let’s look at exactly how to add custom fields to a WooCommerce product.

How to add WooCommerce custom product data fields

It’s really easy to add WooCommerce custom product data fields. First, we need the WooCommerce Product Add-Ons Ultimate plugin.

Using Add-Ons Ultimate has several advantages:

  • Easily add custom fields to any (and multiple )WooCommerce products – for instance, you can create fields that apply to all products, or to all products within certain categories or taxonomies, or to multiple products that you specify
  • Display different custom information depending on which variation the user has selected
  • Organise multiple custom fields into groups to make it easier for the user to view additional product information
  • Create conditions based on custom input fields (see below) so that different information is displayed to the user depending on selections they make
WooCommerce Product Add-Ons Ultimate featured image

WooCommerce Product Add-Ons Ultimate

Personalize products with extra fields and custom options

Find Out More

How to add an ‘Information’ field

You can follow the steps in this support document for installing and activating the plugin. When you’ve activated the plugin, you can add an extra field to your product.

We’re going to add an ‘Information’ field type. So first go to a product that you’d like to display some additional information for.

From the Product Add-Ons section in the Product data panel, click ‘Add Field’. Choose ‘Information’ as the ‘Field Type’.

WooCommerce custom information fields settings

You can enter a ‘Field Label’ that will act as a heading for each row of product information. This makes it easy to organise your product data, helping the user to find what they need.

Then you can add multiple rows for each piece of product information. In each row, you can enter an image, label and data in each.

When you’ve added all the information that you need, you just update the product.

On the front end, the extra product data fields will be displayed in a table format like this:

WooCommerce information fields

You can add as many extra product data fields as you like.

How to add custom fields to multiple products in WooCommerce

So we’ve just looked at a quick and easy way to display extra information about a single product. But what if you want to display that same information about multiple products?

Let’s look at how to add custom data fields to multiple products in one easy step:

  • Go to Product Add-Ons > Global Add-Ons
  • Click ‘Add New Global Group’
  • Select ‘On all products’
  • Then add your ‘Information’ field as normal

This information field will now be displayed on all your products.

How to add custom fields by category or taxonomy in WooCommerce

If you’d like to add custom information fields to all products within certain categories or taxonomies:

  • Go to Product Add-Ons > Global Add-Ons
  • Click ‘Add New Global Group’
  • Select ‘By category’
  • Enter the categories or taxonomies where the custom fields should be displayed
  • Then add your ‘Information’ field

The information fields will be displayed on all the products within your selected categories.

How to display different custom fields based on user selections

So, you might remember way back at the start of this article, that I mentioned using both types of custom field together: WooCommerce add-ons fields and extra product data fields.

We can do this by setting conditions on our extra product data fields so that they are only displayed when the user has made certain other choices from the custom fields.

Let’s look at a different example. In this product, the user can create their own cereal product by selecting different elements. We want to display nutritional information for each element to help the user make their choices.

We don’t want to display all the nutritional information for all the elements at once – that would be overwhelming and unhelpful.

Instead, we just want to display the relevant custom field when the user makes a selection. So in the screenshot above, the user has selected ‘Cheerios’ as their base and information fields showing calories, fat and sugar for Cheerios are displayed.

If the user selected a different option, then they’d see different information fields displayed.

Adding conditions to extra product data fields

There is a much longer article on conditional logic here but the basics are simple:

  1. Click ‘Add Condition’ for the field where you want to add a condition – in this case, to our information field
  2. Choose ‘Show this field if’ in the first select box
  3. Add your conditions one by one

You can see this in the screenshot below:

This means that this field will only display if the user has chosen ‘Cheerios’ in the ‘Cereal’ field.

How to display custom fields for different variations

What about if you want to display different information for different variations? This can also be easily accomplished using the Product Add-Ons plugin:

  • Create your variable product
  • Add as many custom fields as you like
  • In each custom field, you can specify one or more variations where the field should be displayed

In the example below, we can display specific size and fitting information for clothing. Each variation is a different size so we need to show slightly different custom fields.

Variation specific custom fields

You can see this product here. Notice how the size information fields change when you select a different variation.

How to organise custom information fields into groups

Finally, let’s look at how you can organise custom fields into groups. This is especially important if you have a lot of custom information fields.

Going back to our first example, the Build Your Own Computer product, you can see that the fields are organised in groups.

We’ve gone a step further and applied an ‘accordion’ layout to the groups, meaning that the user can choose to expand or collapse each group so that they only view the fields within an expanded group. This makes it much easier for the user when there’s a lot of information on the screen.

You could also apply a tabbed layout instead:

To display your groups in a tabbed or accordion layout, just update the ‘Display groups as’ setting.

Please note that these group layouts are only available in the Pro version of Add-Ons Ultimate.

Adding WooCommerce custom fields – video

The following video covers all the aspects of adding custom fields discussed in this post:

Adding WooCommerce custom add-on fields

We’ve covered the first type, product information fields, in depth above. Let’s now look at the second type of custom field: custom add-on fields.

To add custom add-on fields to WooCommerce products, you’ll need the WooCommerce Product Add Ons Ultimate plugin. It also enables you to add costs, subtract costs, and use conditional logic.

The plugin will also ensure that any custom field data is displayed in the cart, in notification emails, and in the order.

WooCommerce Product Add-Ons Ultimate featured image

WooCommerce Product Add-Ons Ultimate

Personalize products with extra fields and custom options

Find Out More

Let’s look at a simple example.

WooCommerce custom field types

As I mentioned above, custom add-on fields include any kind of form field, such as:

These fields would be displayed on the front end product page near the Add to Cart button. They give customers the opportunity to configure or provide personalised information for the product.

Typical uses for custom fields

If you’re wondering why you would ever need custom fields in your WooCommerce store, think about any of the following product types:

  • Monogrammed or branded clothing and apparel: e.g. any kind of personalised teeshirts, staff uniforms, merchandising, or anything that requires a custom logo
  • Personalised jewellery: e.g. bangles that can be engraved with a name or personal message, lockets that contain photos of loved ones, necklaces or bracelets with optional charms or stones
  • Build your own products: anything from create your own sandwich or pizza products, through takeaway menus, to configurable skateboards, computers or phones – any product that creates optional elements that the user can configure
  • Product Hampers with add-ons: This could be curated product hamper boxes (that use extra product data fields), which come with the add-on options like gift wrapping, personalised gifts cards, etc (which use custom add-on fields)

There are many, many more products where you would need to use custom fields. If you’d like some more ideas, or want to know more baout personalised products, these articles can help:

In summary, it’s worth noting that custom fields will improve customer retention and is likely to boost sales. Typical examples of products with custom fields include:

How to add a custom field in WooCommerce

Let’s take a look at a simple example product. In this product, we’re adding custom fields that will allow our users to personalise an item of jewellery.

Example product showing WooCommerce custom fields

Firstly, we’ll look at adding one of the most common custom field types – a text field – using WooCommerce Product Add Ons Ultimate. We’ll look at:

  • How to add fields in the back end
  • What the fields look like on the front end
  • How the store owner receives the custom field data in new orders

How to add a custom field in WooCommerce

It’s easy to add a custom field to a product in WooCommerce:

  • Go to the product where you’d like to add a custom field
  • In the Product Data section, click the Product Add-Ons
  • Click ‘Add Group’ then click ‘Add Field’
  • Choose the type of field you’d like to add from the ‘Field Type’ option
  • In the option below, I’ve selected a text field as the field type
WooCommerce text input

On the front end, this is what it’ll look like:

WooCommerce custom fields front end

Note that WooCommerce Product Add Ons Ultimate adds some pricing information above the Add to Cart button. This shows:

  • The base price of the product
  • Any additional costs added through extra custom fields
  • The overall total that the customer will pay after entering custom information

You can configure these totals fields by changing their labels, just displaying the total price, or hiding them altogether.

There’s a detailed tutorial on adding a text field to a WooCommerce product page here.

Configuring extra parameters

Returning to the extra field in the back end, you can see that there are several additional options for configuring your custom field. These vary slightly depending on the type of field you’re adding but let’s look at some of the most common ones:

WooCommerce custom fields - text input
  • Field label: this is where you can create a label for your field
  • Field price: want to charge your customers for entering information in this field? Just add the price here. This will get added to the product price automatically
  • Required field: if you’d like to ensure the customer completes this field before adding the product to the cart, then check this option
  • Flat rate: by default, if the field has a price, it’ll be multiplied by the quantity of product added to the cart. So if the field price is $5 and the user adds 2x the product to their cart, the field cost will be $10. If you only want to charge for this field once, irrespective of the quantity in the cart, check the ‘Flat rate’ option
  • Percentage: check this field to make the ‘Field price’ field a percentage instead of a fixed value
  • Min chars: this is the minimum number of characters the user can enter into this field. Leave it empty if there’s no minimum
  • Max chars: the maximum number of characters the user can enter. Leave it empty if there’s no maximum
  • Price per character: check this option if you’d like to multiply the field price by the number of characters entered into the field
  • Default: enter a default value here if you’d like this to display to your customer

For further details on all the extra parameters available to all field types, take a look at the support articles here.

Viewing custom fields in the cart and order details

When the customer adds a product to their cart that contains one or more custom fields, the field values will be added to the product name. Take a look at the example below showing a radio button field, a text field, and an image upload field:

WooCommerce cart custom fields

The same data is passed through to the order. So if you’re the store owner, you can quickly view what custom extras to add to the product:

WooCommerce order custom fields

So that concludes the section on the easy way of adding WooCommerce custom fields to a single product page.

We’ve looked at a simple example of adding a text field to your WooCommerce product page where the customer can enter their own text. This text is then displayed with the product in the cart and will be included with the product in the order.

The text field is just one of many field types that you can add using the WooCommerce Product Add Ons Ultimate plugin.

WooCommerce Product Add-Ons Ultimate featured image

WooCommerce Product Add-Ons Ultimate

Personalize products with extra fields and custom options

Find Out More

So far, we’ve looked at the two different types of custom field and how to add them with a plugin. We’ve also looked at how you can use conditions to display specific fields when the user has chosen certain options.

At this point, you don’t necessarily need to read any more – unless you want to look into how to add custom fields programmatically, which is the subject of the next section.

Adding WooCommerce custom fields using code

If you’d like to find out more about coding custom fields from scratch and adding them programmatically, then read on. By the end, you will have learned to build your own custom field plugin for WooCommerce. The plugin will:

  • Create a custom field in the Product Data section of a WooCommerce product
  • Use the value saved in that field to display a text input field in the product single page
  • Save the user input in the custom field to cart meta data
  • Pass the value of the custom field to the order object

This section is organised into the following parts:

I’ve also included all the code used in the article in its entirety at the end.

Adding a custom field in the back-end

Let’s start by looking at some code to add a custom field to the back-end of WooCommerce. This will add a new field in the Product Data section of a WooCommerce product.

* Display the custom text field
* @since 1.0.0
function cfwc_create_custom_field() {
$args = array(
'id' => 'custom_text_field_title',
'label' => __( 'Custom Text Field Title', 'cfwc' ),
'class' => 'cfwc-custom-field',
'desc_tip' => true,
'description' => __( 'Enter the title of your custom text field.', 'ctwc' ),
woocommerce_wp_text_input( $args );
add_action( 'woocommerce_product_options_general_product_data', 'cfwc_create_custom_field' );

This short function uses a standard WooCommerce function, called woocommerce_wp_text_input, to display a text field in the Product Data section.

WooCommerce custom field

You’ll notice that woocommerce_wp_text_input accepts several parameters, , like ID, label and class.

You can find a complete list of the parameters in the wc-meta-box-functions.php file. There are several cognate functions, all with nice self-explanatory names, like:

  • woocommerce_wp_hidden_input
  • woocommerce_wp_textarea_input
  • woocommerce_wp_checkbox

These functions greatly simplify the task of adding custom fields to WooCommerce products.

Hooking the custom field function

To ensure that the custom field displays in the correct place – in this case, it’s just on the General tab – we need to hook our function to the correct action: woocommerce_product_options_general_product_data.

If you wanted to add your custom field to a different tab, you could try actions like:

  • woocommerce_product_options_inventory_product_data
  • woocommerce_product_options_shipping

Saving the custom field value

Now we need to save the value of the field when the product is updated.

* Save the custom field
* @since 1.0.0
function cfwc_save_custom_field( $post_id ) {
$product = wc_get_product( $post_id );
$title = isset( $_POST['custom_text_field_title'] ) ? $_POST['custom_text_field_title'] : '';
$product->update_meta_data( 'custom_text_field_title', sanitize_text_field( $title ) );
add_action( 'woocommerce_process_product_meta', 'cfwc_save_custom_field' );

This function runs when the product is first published or when it’s updated. It looks for a value in our custom field, sanitises it, then saves it as product metadata using the CRUD methodology introduced to WooCommerce a few versions ago.

The function hooks to the woocommerce_process_product_meta action.

Displaying the custom field on the front-end

Now we can add the custom field to the single product page.

We will check if the custom field has a value. If it does, we’ll use that value as the title of the input field on the front end. The user will be able to enter some text, which will get saved as part of the cart meta data when they add the product to the cart.

WooCommerce custom field frontend

Here’s the code to display the custom field on the product page:

* Display custom field on the front end
* @since 1.0.0
function cfwc_display_custom_field() {
global $post;
// Check for the custom field value
$product = wc_get_product( $post->ID );
$title = $product->get_meta( 'custom_text_field_title' );
if( $title ) {
// Only display our field if we've got a value for the field title
'<div class="cfwc-custom-field-wrapper"><label for="cfwc-title-field">%s</label><input type="text" id="cfwc-title-field" name="cfwc-title-field" value=""></div>',
esc_html( $title )
add_action( 'woocommerce_before_add_to_cart_button', 'cfwc_display_custom_field' );

This function creates a $product object based on the product ID so that it can look in the product meta data for a value for the custom_text_field_title field. If it finds a value, then it will display a text input field and label.

Note that the function is hooked to the woocommerce_before_add_to_cart_button action. Hooking it to this action ensures that the input field is included in the cart form, which means that its value will be available when the product is added to the cart. Which is what we’ll look at next.

Validating custom field values

When a user enters some text into our custom field, we might want to check that the text conforms to some criteria we’ve laid down before we allow the item to be added to the cart. We do that using the woocommerce_add_to_cart_validation filter.

The code below performs a simple check when the user clicks ‘Add to Cart’ to ensure that they have entered some text in the custom field. Essentially, this makes the field required in order for the user to add it to their cart.

* Validate the text field
* @since 1.0.0
* @param Array $passed Validation status.
* @param Integer $product_id Product ID.
* @param Boolean $quantity Quantity
function cfwc_validate_custom_field( $passed, $product_id, $quantity ) {
if( empty( $_POST['cfwc-title-field'] ) ) {
// Fails validation
$passed = false;
wc_add_notice( __( 'Please enter a value into the text field', 'cfwc' ), 'error' );
return $passed;
add_filter( 'woocommerce_add_to_cart_validation', 'cfwc_validate_custom_field', 10, 3 );

The woocommerce_add_to_cart_validation provides you with three parameters:

  • $passed – a boolean value to indicate whether validation is successful or not
  • $product_id – the product ID
  • $quantity – the value of the quantity field

In this function, we simply get the value of the cfwc-title-field, which we added to the cart form in the previous step. If it’s empty, we display a message to the user and set the $passed parameter to false. Because this is a filter, we need to return a value.

How to add a message if the product fails validation

The function uses wc_add_notice to add a message to the WooCommerce notice. This function accepts two arguments:

  • Message – the text to display
  • Status – can be ‘error’, ‘success’, or ‘notice’. Most  themes that support WooCommerce would style these notices differently
WooCommerce validation notice

Adding custom values to the cart

Assuming the product successfully validates, it’ll get added to the WooCommerce cart object. We can add our own meta data to this object so that we can use it later in the process, e.g. on the cart and checkout pages and for orders and emails.

* Add the text field as item data to the cart object
* @since 1.0.0
* @param Array $cart_item_data Cart item meta data.
* @param Integer $product_id Product ID.
* @param Integer $variation_id Variation ID.
* @param Boolean $quantity Quantity
function cfwc_add_custom_field_item_data( $cart_item_data, $product_id, $variation_id, $quantity ) {
if( ! empty( $_POST['cfwc-title-field'] ) ) {
// Add the item data
$cart_item_data['title_field'] = $_POST['cfwc-title-field'];
return $cart_item_data;
add_filter( 'woocommerce_add_cart_item_data', 'cfwc_add_custom_field_item_data', 10, 4 );

This function hooks to woocommerce_add_cart_item_data, which filters the data passed to the cart object when a product is added to the cart. So here we check that the cfwc-title-field has a value then add that to $cart_item_data.

Bonus: If you want to update your product price programmatically, use our guide here: How to update product price programmatically on WooCommerce.

Displaying custom fields in the cart and checkout

Let’s look at how to display the custom field value in the cart and the checkout. We can use the same filter for both pages, so we only need to write one function:

* Display the custom field value in the cart
* @since 1.0.0
function cfwc_cart_item_name( $name, $cart_item, $cart_item_key ) {
if( isset( $cart_item['title_field'] ) ) {
$name .= sprintf(
esc_html( $cart_item['title_field'] )
return $name;
add_filter( 'woocommerce_cart_item_name', 'cfwc_cart_item_name', 10, 3 );

The function checks each item in the cart for our title_field parameter. If it’s set, then it adds the title field to the product name as displayed in the cart.

Note that the woocommerce_cart_item_name filter works on the cart and checkout forms.

Displaying custom field values in the WooCommerce order and email confirmations

Having ensured that our custom field is visible to the user in the cart and checkout forms, we now need to pass its value to the order when the user checks out.

* Add custom field to order object
function cfwc_add_custom_data_to_order( $item, $cart_item_key, $values, $order ) {
foreach( $item as $cart_item_key=>$values ) {
if( isset( $values['title_field'] ) ) {
$item->add_meta_data( __( 'Custom Field', 'cfwc' ), $values['title_field'], true );
add_action( 'woocommerce_checkout_create_order_line_item', 'cfwc_add_custom_data_to_order', 10, 4 );

We can do this very easily using the woocommerce_checkout_create_order_line_item action. Like the filter for the product name in the cart, we just check the cart item for the title_field parameter. If it’s present, we add its value as meta data to the $item object.

This will ensure that our custom field value is displayed on the order confirmation field that the user sees once they have checked out, the order in the backend, and on the confirmation email to the admin and to the customer.

WooCommerce order page

The code for the complete plugin can be found on GitHub.

Advanced Custom Fields for WooCommerce

The Advanced Custom Fields plugin for WordPress lets you customize the WordPress edit screens and custom field data. Users can easily add on custom fields in a few clicks using the robust field builder functionality. It’s a great, all-in-one solution for businesses looking to take their WooCommerce store to the next level. 

The Advanced Custom Fields plugin is also useful for adding extra information to WooCommerce products. You can use it to display additional information for WooCommerce products that is only required on the back-end of your WooCommerce store. 

For instance, you can add important details about WooCommerce products so staff members have an easier time managing the store. This can help your staff figure out stuff like how much stock is left or which product variations are out of stock. 

How to set up Advanced Custom Fields

To add custom fields to your WooCommerce store, you need to install the free Advanced Custom Fields plugin on your WordPress site. Here’s how you set it up:

Create a new field group

Using the WordPress dashboard, navigate to the Custom Fields tab and click the Add New button.

Give the field group a name like “Product Customization”. You can set multiple fields in the same group. This way you can display multiple custom fields for one product or a section of your WooCommerce store. 

Add your custom fields

Click on the Add Field button to add custom fields to the field group.

Add field

Here, you need to set Field Label, Field Name, and Field Type. Add as many custom fields as you’d like.

Field details

If you’re selecting a field that has many options, you’ll need to add your field choices using the text field below Choices. You can also set options such as the default value, the layout, and a value or label. 

Field label

Configure additional field group settings

The next step is to set the Location of the field group. You can choose where you want the field group to appear in your WordPress dashboard using the Location section.

Field location

Set Post Type to Product. Enable the checkbox next to Active under the Settings section. This allows you to set the field group on product pages and show the field selections to shoppers. 

Add information to products

Navigate to the WooCommerce product’s edit page to add custom fields using the field group we created earlier. 

Add fields to product

WooCommerce custom checkout fields

Till now, all we’ve talked about is how to add custom fields to a WooCommerce product. But what if you want your custom fields to appear on the checkout page?

The standard checkout fields built-in WooCommerce by default work great. These include check fields for the name, phone number, email address, billing address and shipping address, and payment information. 

Displaying custom fields on the checkout page in WooCommerce can help you deliver a better user experience. It’s also a great way to gather information from the customer before they checkout. 

Let’s go over a few examples of custom checkout fields for WooCommerce:

  • Delivery date field. You can add a delivery date field to the checkout page to let customers select a delivery date. For instance, florists and bakeries can let customers choose when they’d like to have the goods delivered. 
  • Email newsletter opt-in. When the customer is done with their order and is ready to leave your site, you can offer an email newsletter opt-in using a custom field. This is great for deal sites and stores that offer services such as photography. 
  • Delivery days (subscription products) You can also let customers choose when they want to have the product delivered over multiple days. For instance, you can let customers select from either 3 delivery days a week or 5 delivery days for meal subscription boxes or vegetable subscription boxes

Adding checkout fields programmatically

It’s also possible to add checkout fields to your WooCommerce store programmatically. All you need to do is add a little code to your WooCommerce store. It’s a great option for developers as it offers tons of flexibility and customizability. 

For more information, you can take a look at this guide on WooCommerce Checkout Fields

Adding checkout fields using a plugin

People who aren’t familiar with coding can add checkout fields to their WooCommerce store using a plugin. This is a good option for all types of users as there is no need to code to add custom checkout fields. 

Here are some of the plugins we recommend for adding checkout fields to your WooCommerce site: 

  • Checkout Field Editor. The Checkout Field Editor lets you optimize the checkout process on your WooCommerce site and helps take your WooCommerce store to the next level. You can add, remove, or modify custom fields based on your requirements. 

Further reading

Here are a couple of other articles you might find useful:

  • WooCommerce extra product options – this guide details how you can easily create personalized products through custom fields and options.
  • If you want to know even more about adding custom cart item data in WooCommerce, including details on the woocommerce_add_cart_item_data and woocommerce_add_to_cart_validation filters, check out our guide to adding custom cart item data in WooCommerce which explains how to add custom text fields using a plugin and how to add and validate cart item data using code.

Final thoughts

Hopefully, you’ve been able to follow through step by step how to create, add and save custom field data in WooCommerce. Don’t forget to check out the WooCommerce Product Add Ons Ultimate plugin for extensive extra functionality.

WooCommerce Product Add-Ons Ultimate featured image

WooCommerce Product Add-Ons Ultimate

Personalize products with extra fields and custom options

Find Out More


    • User image

      Hi Dustin – I think that is related to your theme. Can you try testing with a standard theme, like Twenty Seventeen, to see if you get the same problem?

  1. User image


    Thank you for these golden information I really needs it.

    But, I have one question can I show the custom fields in the product page depends on the category.
    For example I sell many items in my website ( Books, Electronics, Clothes) So for book I only want to show ISBN, Publisher, Author but in clothes for example size and color but if I use that code now and add all these custom fields it will show in all the product category is there any way to show the custom fields depends on my category?

    Thanks in advance,

  2. User image

    Thanks for the excellent article, where can i find more information on the “woocommerce_product_options_general_product_data” functions, i could not find anything in the woocommerce documentation.

  3. User image

    Great article,

    Is it possible to update a custom meta value that was added to the product as it was added to the cart.

    I’m able to establish the cart item key of the item I want to update but then unsure how to update the meta value?

    Any suggestions would be really appreciated.

  4. User image

    Hi, great job!!!
    I’m testing this script (in functions.php file) and works OK, but for the products that don’t have a custom field assigned in the back-end (so no custom text field is displayed on the front-end product page), the validation keeps failing and the clients is getting the warning “Please enter a value into the text field” every time they want to add a product to the cart. In the products WITH custom field assigned and displayed -and when the client enter some text-, it’s OK, but not in the rest of the products. What can I change in the code to solve that? Thank you!!!

      • User image

        Hi Gareth!
        Really appreciate your answer!! But maybe this is the whole point of the plugin? I mean it’s supposed the validation will be effective only on products that have custom fields, the validation must not make interference with other products that don’t have a custom field assigned, or the buying process at all. If you put this code “as is” then the “add to cart” button become useless (please try to see it in action).
        Please, could you be so kind to give us a hint or maybe consider improving the current code??
        Thanks again!!!!

          • User image

            Hi Gareth, I really don’t believe anyone is trying to get things for free. Anyway, I wonder if you guys are aware that if you put this code the Store gets useless and the “add to cart” button will be deactivated (do nothing) without any clues for the front-end users? My intention is to contribute to improving this code. I’m wrong? Thanks again!

  5. User image

    Hi Gareth,
    Thanks for your code!
    But I have a problem with that. MiniCart ( woocommerce_mini_cart() ) show old value without changes. That’s because hook “woocommerce_before_calculate_totals” not load when minicart show. To solve this problem, I slightly changed your code:

    function cfwc_before_calculate_totals( ) {
    if ( is_admin() && ! defined( ‘DOING_AJAX’ ) ) {
    $cart = WC()->cart->get_cart();
    // Iterate through each cart item
    foreach( $cart as $key=>$value ) {
    if( isset( $value[‘total_price’] ) ) {
    $price = $value[‘total_price’];
    $value[‘data’]->set_price( ( $price ) );
    add_action( ‘woocommerce_before_calculate_totals’, ‘cfwc_before_calculate_totals’, 10, 1 );
    add_action( ‘woocommerce_before_mini_cart’, ‘cfwc_before_calculate_totals’, 10, 1 );

    This code works fine for me.

  6. User image

    Hey, awesome tutorial. I am wondering if there is a solution to hook the plugin elsewhere than at “woocommerce_before_add_to_cart_button”? I would like to place it at the position “woocommerce_after_single_product_summary” for several reasons, but it is not working obviously. Any hints on that are highly appreciated 🙂

  7. User image

    Displaying custom fields when you “edit an item from the cart page”.

    I can’t get the current item key from the cart. I was a lookup in the whole cart but I didn’t find how to retrieve the current item key or id for making a diff, after that when you come for edit item from the cart then the data is no available to show again in the customs fields.

    • User image

      You can use something like this to get item keys from the cart:

      $cart = WC()->cart->get_cart();
      // Iterate through each cart item
      foreach( $cart as $key=>$value ) {
      // ... Do something

      • User image

        Hi Gareth, thank you for the advice. In fact, I do that but I can’t do a difference with “the current item”. For example: if I have the same item with different custom field then the id_procut is the same one, the keys are different but I cannot choose which one is for each.

  8. User image

    Hi Gareth,

    Thank you for the amazing tutorial. Does your plugin work with variable products? I’ve followed every step and everything works fine until I get to “Calculating The Custom Price”, it doesn’t seem to add the correct variation price, only works with simple products. Can you please confirm? Thanks man, I’ll be eternally grateful!

  9. User image

    Hi Gareth,

    Just found the way to adjust it for variable products by changing the “wc_get_product” settings to “variation_id” instead of “product_id”. Again, thank you for this great tutorial, it works perfect.

  10. User image

    Love that tutorial – thanks for your work!
    I was wondering if it is possible to use it with variations, I already tried a lot of things, a lot is already working.

    The custom fields are displayed and stored successfully in the backend.
    But I’m struggling to use this for the specific variation – it always uses the values of the first variation…
    Which is absolutely right, since I didn’t use the variation_id, but I don’t know how 🙁 Can you help?

    Here is the necessary part of my code:
    function cfwc_validate_custom_field( $passed, $product_id, $quantity ) {
    $product = wc_get_product( $product_id );
    $title = $product->get_meta( ‘custom_text_field_title’ );
    $max_size = $product->get_meta(‘custom_text_field_max_size’);
    $one_size = $product->get_meta(‘custom_text_field_1_size’);
    $two_size = $product->get_meta(‘custom_text_field_2_size’);
    $three_size = $product->get_meta(‘custom_text_field_3_size’);

  11. User image

    Hello. Thank you for the info. I’m using your code to create a custom field in my site. 🙂
    I just need to use the Custom Text Field Title to show that title in product page and in checkout page. I don’t need the field to the user can leave text.
    Any idea how to achieve that? Thank you 🙂

  12. User image

    how to hook the custom function woocommerce_product_options_general_product_data. as i can able to see the fields in backend in the product but but can not able to see the frondends.

    kindly help me.

  13. User image

    Hello Gareth,

    First of all thanks for this great article, everything is explained in detailed.

    I am having an issue, the products on our site are marked as “Sold individually” as you can see here in the screenshot: http://prntscr.com/m0oefm

    So when we try to add the same product with different custom field values, they are adding screenshot: http://prntscr.com/m0ogkw . I want to restrict it to allow only buy a single product with any custom field value, no same products with different values.

    Can you please guide me how i do this?

  14. User image


    I have customized the “cfwc_validate_custom_field” function to limit product purchase.


    Now, I am trying to add this custom field in product loop on shop page.

    By adding this hook along with the existing
    add_action( ‘woocommerce_before_add_to_cart_button’, ‘cfwc_display_custom_field’ );
    add_action( ‘woocommerce_after_shop_loop_item’, ‘cfwc_display_custom_field’, 9 );

    The field is now appearing in product loop and product single page.

    But when i try to “add to cart” this product from loop with custom field filled, its not passing this field data and gives error that custom field is empty.

  15. User image

    I wanted to pass the field value to the order details page without showing it on the front end but it didn’t work, is it possible?

  16. User image

    Hi Gareth,

    Your code worked but it’s missing one little detail.

    When you go to checkout, the field and its value are shown, but when you are in the cart they are not. At least that’s the behavior in my implementation. Can you confirm this?


  17. User image

    Dear Gareth,

    first of all thank you for this awesome article, it helps me a lot and i did a lot of research to find this article :-).

    I am having an issue, the products on our site are marked as “Sold individually”.

    Can you please guide me how i do this? Is there any update coming soon?

  18. User image

    Hi Gareth, thank you so much for this great post, it’s very helpful for who like me is just coming around Woocommerce!
    I have a question for you as I’m having troubles with it.
    I need to know if the user has bought a product with a custom field == a given ID.
    To be precise, the given ID is the ID of the current post, so get_the_ID().
    And the custom field of the products is, let’s say, “id_rel_post”.
    How can I make the same research but checking if the custom field of the product matchs and not the id of the product?
    Thank you so much!!!

    • User image

      Hi Lia – if you’re using the custom code above, you can use something like this:

      $product = wc_get_product( get_the_ID() );
      $field_value = $product->get_meta( 'id_rel_post' );
  19. User image

    Thank you for this great tutorial. I would like to retrieve the value of the custom field on the product page, when we click on the product on the cart page. To prevent the user from re-entering it. In the url I can see the attributes (…/? attribute_pa_color = green& attribute_pa_taille = l) but not the value of the custom field. An idea of how?

    • User image

      On the cart page, you could use the woocommerce_cart_item_permalink filter to add your custom field as a parameter to the product link.

      Then, on the product page, you’d need to use $_GET to retrieve the value of the parameter and populate the field.

  20. User image

    Hi Gareth,

    thanks for this in-depth tutorial. Is it possible to show the custom field information only in the confirmation email or on the Thank You Page and not on the product page?

    My customers should get a link with every product which they should see after the purchase. The link is unique with every product type. I thought maybe I could include the link as a custom field and then hide it at the shop itself and display it in the confirmation email?

    Would be awesome if the plugin could help me out. Thanks for your support!

    Best regards,

  21. User image


    Thanks for this info. I have an issue I cannot get it to save the select value. This is what I have.

    I hope You can help me out.


    function cfwc_create_custom_field() {
      $args = array(
      'label' => __( 'Producttype', 'ctwc' ), // Text in Label
      'class' => 'select short custom_shipping-type',
      'style' => '',
      'wrapper_class' => '',
      'value' => '', // if empty, retrieved from post meta where id is the meta_key
      'id' => 'custom_shipping-type', // required
      'name' => '', //name will set from id if empty
      'options' => [
                'Eigen product' => __( 'Eigen product', 'ctwc' ),
                'Probo (klein)' => __( 'Probo (klein)', 'ctwc' ),
                'Probo (lengte)' => __( 'Probo (lengte)', 'ctwc' ),
                'Probo (volume)' => __( 'Probo (volume)', 'ctwc' ),
      'desc_tip' => 'true',
      'custom_attributes' => '', // array of attributes 
      'description' => __( 'Selecteer type.', 'ctwc' )
    	woocommerce_wp_select( $args );
    add_action( 'woocommerce_product_options_shipping', 'cfwc_create_custom_field' );
     * Save the custom field
     * @since 1.0.0
    function cfwc_save_custom_field( $post_id ) {
    	$product = wc_get_product( $post_id );
    	$title = isset( $_POST['custom_shipping-type'] ) ? $_POST['custom_shipping-type'] : '';
    	$product->update_meta_data( 'custom_shipping-type', sanitize_text_field( $title ) );
    add_action( 'woocommerce_process_product_meta', 'cfwc_save_custom_field' );
  22. User image

    Hi, I’m trying to implement your code but I prefer to display the input field inside the cart page, there is a way to do that?

    Right know I just change this

    add_action( ‘woocommerce_after_cart_item_name’, ‘cfwc_create_custom_field’ );
    //add_action( ‘woocommerce_product_options_general_product_data’, ‘cfwc_create_custom_field’ );

    Thanks in advance

  23. User image

    Hi there. This article is all that I need for what I have to achieve. But, I cannot figure out where does the “cfwc-title-field” in %s come from? This lack of understanding is actually preventing me to display more than one custom field.

  24. User image

    Hi, when I install this code, the Validate the text field code seems to run for all products, including ones that I don’t use the text field on. Is that normal behaviour?

  25. User image

    Hi Dear Friends,
    I want to add add on details on shop page and category page itself. How to add drop-down option (Choose option) in shop page and category page? Because in my website, I don’t have product description page. Anyone can help me. All the plugin works only in product description page. i don’t know how to display custom fields in shop page itself.

  26. User image


    I really glad about your tutorial and I altered it a bit for my need, but I notice one thing. When I use the “YOU MAY BE INTERESTED IN…” part to add a product to the cart the custom field is not being set.

    Any suggestions where to look / how to fix this??

    • User image


      The custom field is part of the product page’s add to cart form – so you need to go to the product page and select custom fields from there.



      • User image

        Hello Gareth,

        Yes, so I noticed. Is there a way to have the custom field also be part of the “Add to Cart” link? For example if I am on the shop overview page I see thumbnails. Now on rollover, I am able to click “Add to Cart” -> the product is added but not with the custom field.

        The link behind “Add to Cart” reads /?add-to-cart=375, but like you said the “Add to Cart” link is a form button. So is there a way to have the custom field be sent by solely a link???


  27. User image

    Hi, thanks for such a wonderful tutorial, I’m having a little confusion. That is, where to write this code in order to get make a custom field for product.
    function cfwc_create_custom_field() {
    add_action( ‘woocommerce_product_options_general_product_data’, ‘cfwc_create_custom_field’ );

  28. User image

    Thank you very much for this, it works very well!
    One thing that I am struggling with figuring out is how to display the custom field values inside a WC_Order_Query loop on the frontend? My loop works as expected, and I am able to display values such as the order ID, the Billing First Name, the Date Created, etc. but I just don’t understand how to get the value for the fields we create with this plugin.

    If anyone could assist me with this, it would be greatly appreciated 🙂

    Thank you in advance!

  29. User image

    Hi Gareth,
    thanks so much for this, really helpful. My ultimate goal would be to add the custom field data to the ‘Order notes’; I’m struggling with this. Any suggestions? Thanking you in advance.

  30. User image

    Is there a way to conditionally hide/show billing fields based on if the cart total is >$0? When there’s a 100% off coupon, I don’t want to require users to enter billing info.
    Thanks in advance,

  31. User image


    Very well done.
    I’ve tried to get the plugin working with Variable product but so far no luck.

    Any suggestions on that?

  32. User image

    Hi Gareth,

    Just purchased your plug-in so far so good! I want to hide the totals fields on the product page. I would hide the class “pewc-total-field-wrapper”. Before I do is there a setting to do that?

    Cheers, Jeffrey

  33. User image

    That works like a charm, but how can you display the value of the field in the order details on the admin section?

    The hook is woocommerce_before_order_itemmeta, but I cant find the value of the field…

    Kind regards

  34. User image

    Hi, is the “extra product data fields” option available only in premium version ? cause I don’t see the product add-ons tab in the product editor ? however I could add a customer option but that’s not my goal. Thnaks

  35. User image

    Hi Gareth,

    This article helped me greatly. I do have a question about automating this. I want to be able to upload custom add on information for each product as I bulk upload through the product importer but not seeing how at the moment.

    After I manually added the fields, export the CSV and then view it, I don’t see the custom field information associated with it.

    I assume this is possible and looking for some guidance or documentation on how to achieve it.


  36. User image

    Adding a custom field shows up on the product detail page but not on the product category page. How can i add a simply subtitle which shows up on all product related pages?

    I would need a subtitle just below
    Build Your Own Computer

    Kind regards,

  37. User image


    thx for the great tutorial.

    Is it possible to add plain text for each product? I dont need the customer to do an input.

    What I need is:
    Price: 499€
    Monthly Fee: 49€
    Activation Fee: 29€
    Monhtly fee and activation fee is just a simple text. It has no function (and no calculation for the price) for the checkout at all.

  38. User image

    Hi Gareth!

    Awesome tutorial!

    If it’s not too much trouble, can you teach me how to enabled the custom field only for certain products?

    Thank you so much!

  39. User image

    Hi, Great work but I tried your code and i’m facing to issues, the product are still being added to the cart even if you don’t put nothing in the field and for the product that don’t required personalization I got the error message too even if i’m not displaying the field…

    • User image

      Okay, make sure you have included the validation code and that you are not using an AJAX add to cart button. Sometimes these don’t use the WooCommerce filters after adding a product to the cart.


      • User image


        I was actually using an AJAX add to cart button and Almost everything is working smoothly now. I just have a tiny issue. When you go to the cart, the field and its value are shown, but when you are on the checkout page they are not.

        I red all the comment and Javier had the same problem but for the cart. Can you help with that?

        Again thanks for your time and the work that you are doing

        • User image

          Nevermind I got the checkout to work but I can’t get the custom fields to display the informations in the WooCommerce order and email confirmations.

          Here is my code i change the input field by a select (and if you wondering why not using the variable product instead is because i’m using a custom product data who doesn’t allow variation)

          * Display custom field on the front end
          * @since 1.0.0
          function hpplrs_display_custom_field() {
          global $post;
          // Check for the custom field value
          $product = wc_get_product( $post->ID );
          $title = $product->get_meta( ‘custom_text_field_title’ );
          // display in lottery.php


          ‘ . __(‘Select your size’, ‘hpplrs’) . ‘

          esc_html( $title )

          add_action( ‘hpplrs_before_single_product_qty’, ‘hpplrs_display_custom_field’ );

          * Add the text field as item data to the cart object
          * @since 1.0.0
          * @param Array $cart_item_data Cart item meta data.
          * @param Integer $product_id Product ID.
          * @param Integer $variation_id Variation ID.
          * @param Boolean $quantity Quantity
          function hpplrs_add_custom_field_item_data( $cart_item_data, $product_id, $variation_id, $quantity ) {
          if( ! empty( $_POST[‘hpplrs-size-select’] ) ) {
          // Add the item data
          $cart_item_data[‘title_field’] = $_POST[‘hpplrs-size-select’];
          $product = wc_get_product( $product_id ); // Expanded function
          $price = $product->get_price(); // Expanded function
          return $cart_item_data;
          add_filter( ‘woocommerce_add_cart_item_data’, ‘hpplrs_add_custom_field_item_data’, 10, 4 );

          * Display the custom field value in the cart
          * @since 1.0.0
          function hpplrs_cart_item_name( $name, $cart_item, $cart_item_key ) {
          if( isset( $cart_item[‘title_field’] ) ) {
          $name .= sprintf(
          ”. __(‘Size’, ‘hpplrs’) .’: %s’,
          esc_html( $cart_item[‘title_field’] )
          return $name;
          add_filter( ‘woocommerce_cart_item_name’, ‘hpplrs_cart_item_name’, 10, 3 );

          * Add custom field to order object
          function hpplrs_add_custom_data_to_order( $item, $cart_item_key, $values, $order ) {
          foreach( $item as $cart_item_key=>$values ) {
          if( isset( $values[‘title_field’] ) ) {
          $item->add_meta_data( _e( ‘Size’, ‘hpplrs’ ), $values[‘title_field’], true );
          add_action( ‘woocommerce_checkout_create_order_line_item’, ‘hpplrs_add_custom_data_to_order’, 10, 4 );

  40. User image

    This is a great plugin. I have some extra requirements like, After activated the plugin and clicked on the product, and added my product short description.
    Now I need 2-3 editors in the add product to add the Ingredients information, Steps to use, and shipping information. It will be same like a short description.

    How can I add this? Is it possible to add more than one product short description editor?

    For example:
    product short description
    // short content
    Ingredients information
    //Ingredients content
    Steps to use
    // Steps content
    shipping information
    // shipping content

    Please help me in this.

  41. User image

    Hi Gareth, great explanation 🙂

    I don’t know if I’m of the track but I’d like to create a new product type = URL link! So when the buyer purchases they will not see a download button, as when ‘Downloadable’ is clicked under Simple Product Type, but just a link should appear. So in essence the user buys a link to a (hidden) webpage. By subscribing to the site the user will always be able to see the link.

    Can this be achieved by custom fields or should I go down the membership/premium content route? A membership plugin seems bloated in order just to change the product type…

  42. User image


    I really like your Plugin, especially how the one with the custom details with images for computers. Is there a way to show that details with images in the category / shop page, under the photo of the product?

  43. User image

    I am looking to add additional information into my products and I am having a hard time finding a plug-in that will do the job.
    I am running a disc golf retail business and every disc has different “Flight Numbes”. I want to display these numbers in colored boxes or circles so customers can see how the discs fly.
    A great example of what I am referring to can be found on: discmania.net
    Is there a plug-in or shortcode that I can use to make this happen?
    Thanks for all of your help!

  44. User image

    hi, i have a questions, if my site is using woocommerce bookings, and i would like to allow my customer to book a slot, sometimes they might add to cart up to 3-5 times (meaning to say 3-5pax) however I need to collect details such as name, email and phone from how many person added in the cart, can this be done? meaning the field show based on the amount in the cart / selected

  45. User image

    Great article. It seems that the code snippet under the 3rd header below is no longer working, I get a WordPress critical error:
    – Adding a custom field in the back-end (works fine)
    – Saving the custom field value (works fine)
    – Displaying the custom field on the front-end (throws the Wordpress critical error)
    Thank you

  46. User image

    Since my last comment, I went ahead and hired a PHP guy to alter the code to get it to work for me. I have decided to share it here for others who may need it.

    All I wanted was to have a custom field I could enter unique HTML into for each unique product as required, and have the HTML render and display in an Astra theme hook on the single product page(s).

    The following code does not include functionality for the above headers in this post:
    – Adding custom values to the cart
    – Displaying custom fields in the cart and checkout
    – Displaying custom field values in the WooCommerce order and email confirmations

    Here is the code, working in Woo version 7.7.0, WP version 6.2.1:

    * Add custom text field to product page
    * Only for display on the front-end, not carried over to cart, checkout, or order meta

    // Add custom field to product in backend
    add_action( ‘woocommerce_product_options_general_product_data’, ‘cfwc_create_vc_custom_field’ );
    function cfwc_create_vc_custom_field() {
    woocommerce_wp_textarea_input( array(
    ‘id’ => ‘view_collection_text_field’,
    ‘label’ => __( ‘View Collection’, ‘cfwc’ ),
    ‘class’ => ‘cfwc-vc-custom-field’,
    ‘desc_tip’ => true,
    ‘description’ => __( ‘Enter your data.’, ‘ctwc’ ),
    ) );

    // Save custom field value
    add_action( ‘woocommerce_process_product_meta’, ‘cfwc_save_vc_custom_field’ );
    function cfwc_save_vc_custom_field( $post_id ) {
    $product = wc_get_product( $post_id );
    $view_collection_field_value = isset( $_POST[‘view_collection_text_field’] ) ? $_POST[‘view_collection_text_field’] : ”;
    $product->update_meta_data( ‘view_collection_text_field’, wp_kses_post( $view_collection_field_value ) );

    // Display custom field on single product pages
    add_action( ‘astra_woo_single_title_after’, function() {
    $view_collection_field_value = get_post_meta( get_the_ID(), ‘view_collection_text_field’, true );
    if ( $view_collection_field_value ) {
    echo ” . wp_kses_post( $view_collection_field_value ) . ”;
    } );

  47. User image

    Is it possible to display custom fields somewhere other than before the “add to cart” button? I would like to display these custom fields under the tabs.
    Thank you for your help 🙂

    • User image

      Hi Sophie

      This would be possible with some custom JS. I’d be happy to discuss that with you directly if you like? You can contact me on hello[at]pluginrepublic.com


  48. User image


    I want to add custom field in product . and use that field in product search. I am using woocommerce for product. also i have triedit with ACT and ACF: Better Search plugin but it is not working

    Can you please

Leave a Reply

Your email address will not be published. All fields are required.