5Hrs
34Mins
21Secs

LAST CHANCE BLACK FRIDAY SALE

Get a final 25% off before it's too late! Code: LASTCHANCE
Buy Plugins

WooCommerce custom fields: How to create & display

November 10, 2022

WooCommerce custom product fields plugin

This is the complete guide on how to create WooCommerce custom fields. You'll learn how to show extra product data and sell extra product options on your website.

WooCommerce comes with lots of ways to store product data. There are all the standard product fields such as the name, price, categories, tags, and dimensions. There's also the option to create product attributes.

But what if you want to store extra product fields? What if you want something more flexible than product variations, such as checkboxes or text fields? Well, that's where WooCommerce custom fields come in.

2 types of WooCommerce custom fields

When people talk about WooCommerce custom fields, they typically mean one of two things:

  1. Selling extra product options, as an alternative to variationsThis involves adding extra fields containing dropdown lists, checkboxes, radio buttons, text fields etc. for the customer to complete before adding the product to their cart. Technically, extra product options aren't custom fields at all - they're better known as product add-ons! However, a lot of people refer to these options as custom fields.
  2. Adding extra information about the productThis is the classic use of custom fields. In WordPress, custom fields are used to add additional data to posts, pages or products. You use these to store and display extra information on your website.

Keep reading to learn how to add both types of custom fields to your WooCommerce products. You'll discover how to add them and then display them in your store. This makes it easy for customers to see the custom fields and (if you're using add-on fields) add them to the cart.

Using custom fields to provide options and collect information from customers

WooCommerce extra add-on fields with images, swatches and text field
A product with various extra fields added, as an alternative to variations

So far, we've talked about how to use custom fields to create and display extra information about your products. Next, we'll talk about the other type of WooCommerce custom fields - selling additional options to your customers.

This type of custom field doesn't just show extra information about the product. It actually provides extra options which the customer can select before adding the product to their cart. It's a fantastic alternative to product variations because you can add a wide range of field types, instead of just dropdowns. By adding extra field information on the product page, customers can provide extra choices and data which you receive along with their order.

Introducing the Product Options plugin

WooCommerce Product Options is the best plugin for adding product custom fields that allow shoppers to add extra options to their cart.

You can add a wide range of options that appear as custom fields for the customer to select. Shoppers can complete these extra fields and add them to their cart from the following locations:

  • The individual product page.
  • From your main product list, if you're using WooCommerce Product Table.
  • From a quick view lightbox, if you're using WooCommerce Quick View Pro. (Customers can access the lightbox from the main shop page or product category pages, so it's a quick way to select add-on custom fields without having to visit a separate page for each product.)
Displaying WooCommerce add-ons in the WooCommerce Product Table
Example of WooCommerce Product Table used with Product Options
WooCommerce Quick View Plugin Product Add-Ons
Example of Product Options used to display the custom fields in a WooCommerce Quick View Pro lightbox
Add extra options and flexible add-ons to your WooCommerce products in seconds.

Using WooCommerce custom fields to store extra product data

So far, we've learned how to add dynamic fields to your WooCommerce products so that you can collect extra information from customers. That's one way of interpreting the phrase 'WooCommerce custom fields'. The other involves adding static data to your products, and displaying this in your store.

A lot of people add custom fields programmatically, but this is a guide for non-developers. Keep reading to learn how to add custom fields to WooCommerce products - and show them on the front end of your website - without writing a single line of code. You'll learn how to show extra product fields anywhere you like, including on the single product page, shop, and category pages.

After creating our product custom fields, we'll display them in the front end using the WooCommerce Product Table plugin. This makes it easy to display custom fields created by any plugin in a table, anywhere on your site. You can either list multiple products and their custom fields, list products with a specific custom field value only, or add a table of custom fields to the single product page.

WooCommerce product table custom field columns
WooCommerce Product Table plugin displaying custom fields in the front end
Start showing extra product data on your WooCommerce store today!

First, I'll share a real-life case study about a company that uses WooCommerce custom fields to provide extra information about its products. Afterward, I'll provide full instructions on how to create your own Woo custom fields and display them on your product listings.

Case study – How Wavelength Electronics use custom fields in their WooCommerce store

Wavelength Electronics sell technical products in the electronics industry. As with most technical products, customers need to check a lot of information before making their purchase. With all the extra product data to display, Wavelength Electronics used our WooCommerce Product Table to create WooCommerce custom fields to help their clients quickly find what they’re looking for.

The product table now displays a datasheet column with a PDF icon for each item, so customers can open up the datasheet straight from the product table. There’s also a column with ticks to show which models include a temperature controller.

Read on to find out how to add your own WooCommerce custom fields to your store.

See WooCommerce custom fields in action on our custom fields demo page.

WooCommerce custom fields or taxonomies?

I'll start by explaining the difference between two types of WooCommerce product extra fields: custom fields and taxonomies. Understanding this will help you decide which one to use.

Difference between WooCommerce custom fields and taxonomies
Custom field for 'Condition', custom taxonomy for 'Colours'.

What are WooCommerce custom fields?

Custom fields add extra fields to the Add/Edit Product screen in WooCommerce. They're ideal for storing standalone data about products. Here are some examples of when you should use WooCommerce custom fields:

  • To store a unique product barcode, inventory, or reference number.
  • For adding extra ways for people to interact with your products. This might be by adding extra buttons (e.g. 'Enquire about this product), icons or social sharing links.
  • To display multimedia content about the product, such as embedded video or audio tracks.
  • For adding shortcodes provided by other plugins, such as a WooCommerce Add to Quote or Wishlist plugins.
  • To store additional notes about the prices or alternate price options. For example, if you're using a bulk discount WooCommerce plugin and want to list the quantity-based discounts, then you can add this information to a custom field.

The idea of a custom field is that it stores unique information. Since the data stored in the field is unique, you can display it in the WooCommerce front end - e.g. on the product detail page, shop or category pages. However, you wouldn't expect to use this data to group or filter products. If you want to filter by that type of data, then you need a custom taxonomy instead.

You can create WooCommerce custom fields using any custom fields plugin. Once you've created the custom fields, it's easy to show them on your website using the WooCommerce Product Table plugin. Keep reading for full step-by-step instructions on how to do all this. First, I'll quickly tell you about WooCommerce custom taxonomies so that you can be sure you're choosing the most appropriate field type for your data.

What are WooCommerce custom taxonomies?

Like WooCommerce custom fields, taxonomies are a way to store and show extra product data. However, the difference is that they are designed to store re-usable information which can be used to group and filter products. For example, you can create a dedicated archive page listing all products that share a specific custom taxonomy term. You can also use taxonomies to filter products using the WooCommerce Product Table plugin.

Custom taxonomies are very similar to WooCommerce product categories. In fact, WooCommerce categories are actually set up as a taxonomy under the hood. When you create a custom taxonomy in WooCommerce, it adds tick boxes/checkboxes to the right-hand side of the Add/Edit Product screen - just like categories.

Here are some examples of when you might use WooCommerce custom taxonomies:

  • A WooCommerce bookstore needs to store extra product data such as year of publication, author, and publisher. Since more than one book has the same year, author, or publisher, customers need to be able to sort and filter by this data. You can do this using WooCommerce custom taxonomies.
  • If your products relate to a specific geographical area, then you can use custom taxonomies to group products by area. For example, you could create a custom taxonomy called 'Area' and add a separate taxonomy term for each state or county. Customers can then filter by area, or view lists of products from a specific area only.
  • A WooCommerce clothes store can use custom taxonomies to store extra data such as brand name. Customers can then search and filter to find products with their favorite brands, as this field isn't built into WooCommerce as standard.
In summary, use custom fields for unique one-off data, and taxonomies if you want to use the data for filtering or other types of grouping.

Read our tutorial about how to create WooCommerce custom taxonomies.

How to create WooCommerce custom fields in the back end

Ok, now you know when to use custom fields. Next, I'll show you how to create extra WooCommerce product fields. It's surprisingly easy!

Which WooCommerce custom field plugin?

First, you'll need a custom fields plugin. There are plenty of good free plugins for creating custom fields in WooCommerce, including Easy Post Types and FieldsAdvanced Custom Fields and Toolset. You can also use a dedicated WooCommerce custom fields plugin if you prefer.

I'm going to show you how to create WooCommerce custom fields using Easy Post Types and Fields, and also Advanced Custom Fields. These are my two favourites.

The tutorial instructions are the same for most other custom field plugins. If the custom fields don't show up on your site when you follow the later sections of this tutorial, make sure the plugin isn't adding extra characters to the start of the custom field name. (You might need to contact their plugin support to ask about this.) For example, Toolset Types automatically adds adds wpcf- to the start of the custom field name, so you need to know this.

Creating WooCommerce custom fields with Easy Custom Post Types & Fields

Easy Post Types and Fields makes it easy to add custom data fields to your WooCommerce products. It was designed to make it as quick and easy as possible to add custom fields. It comes with a choice of plain text and visual editor custom field types. Use it if you want a quick and straightforward option.

  1. Log into WordPress and find Plugins → Add New. Search for ‘Easy Post Types and Fields’, then install and activate the free plugin.
  2. The setup wizard will open. Skip this and go to Post Types → Manage and click on the 'Other Post Types' tab.
  3. Find the 'Products' post type (this is added by WooCommerce) and click 'Custom Fields'.
  4. Click the button to add as many fields as you like to your WooCommerce products. Make a note of the name of each custom field - you'll need this to display it later in this tutorial.
  5. Finally, edit your products. On the 'Edit Product' screen, you'll find the custom fields that you added in step 4. Fill in the data as needed.

How to create WooCommerce custom fields with the Advanced Custom Fields plugin

Advanced Custom Fields (ACF) is the market leading custom field plugin. Use it if you're willing to spend a bit more time on setup and want extra features such as additional field types.

  1. Log into WordPress and find Plugins → Add New. Search for ‘Advanced Custom Fields’, then install and activate this free plugin.
  2. Click ‘Custom Fields’ on the left-hand side of the WordPress dashboard.
  3. Click the ‘Add New’ link by the ‘Field Group’ at the top of the page.
  4. How to create WooCommerce custom fields
    Next, you'll see the ‘Add New Field Group’ page:
    1. First, add a name for the group of custom fields you're creating. (No one else will see this.)
    2. Location – Choose Show this field group if Post Type is equal to Product. This tells Advanced Custom Fields to show the custom field on the Add/Edit WooCommerce product screen.
    3. Press the blue ‘Add Field’ button. Now it's time to create the individual custom fields where you'll store the extra product data.
    4. Add a Label for the custom field. This is how the custom field will be labelled on the Add/Edit Product screen.
    5. Choose a Name for the custom field (this should be 1 word in lowercase). You'll need this to display the WooCommerce custom field on the front end of your website, later.
    6. Choose a Field Type from the available types of custom field. You can choose text, text area, numbers, checkbox, radio button, etc.
    7. Complete any extra fields for the custom field such as adding a default placeholder value. Finally, click the blue ‘Publish’ button.

That's how to create WooCommerce fields. The next step is to add data to the custom field value for some or all of your products. To do this, go to the 'Edit' page for each product and you'll see the extra WooCommerce custom field(s) lower down the page. They'll be shown somewhere below the Product Data section. Edit the placeholder, enter values into the custom fields and then save the product.

Adding custom fields to product variations

So far, you've learned how to add custom fields for storing data about individual WooCommerce products. If you're using variable products then you can also add custom fields to specific variations. You'll need a different custom field plugin for that - one that focusses on variable products. I recommend Iconic's WooCommerce Custom Fields for Variations plugin for this.

In this screenshot, you can see a product table (created using the WooCommerce Product Table plugin) which lists each variation its own row. There is a custom field column displaying unique data for some of the variations:

WooCommerce variation custom fields plugin


Displaying WooCommerce custom fields in the front end

How to show WooCommerce custom fields on the shop page

Show WooCommerce custom fields

A product table with a custom field column

So far, you've learned how to store WooCommerce product extra fields in the back end of your WordPress website. That's fine if you're just storing extra notes for internal purposes. But what if you want to show WooCommerce custom fields on the front end of your website? We'll get to this now!

The easiest way to show your extra product data is to install the WooCommerce Product Table plugin. This takes your products and lists them in a quick order form layout anywhere on your site. You can add product tables to any page you like. This might be normal pages, or your WooCommerce shop and category pages.

You can choose which columns to include in the product table. The great thing is that you can include WooCommerce custom fields in the table. This is more flexible than the default store layout, which just lists basic information such as the product name and price. It's a really easy way to display the extra product data that is stored in custom fields.

Get WooCommerce Product Table

How to do it

  1. Get WooCommerce Product Table and install and activate the plugin.
  2. The plugin setup wizard will open. Activate your license key and choose the other settings for your product tables.
  3. In the Columns section of the wizard, make sure you add your custom field columns. To do this, just add cf: followed by the name of the custom field name that you created earlier (e.g. cf:my-custom-field). The knowledge base contains the full list of available columns.
  4. Now it's time to add product tables to a page. (You can skip this step if you used the setup wizard to show product tables on your main shop pages.) To add a product table anywhere, use the [product_table] shortcode to list all your products. Alternatively, use the plugin documentation to list specific products only.
  5. Next, view the page and see what it looks like! You will see a product table, complete with custom fields. 

Make changes to how your custom fields are displayed

So far, I've shared a simple method to show WooCommerce custom fields in the front end of your website. Now, let's get more advanced and configure how our custom fields are displayed.

WooCommerce Product Table is a very flexible plugin. Choosing your columns is just one of over 50 options! Look at them all and configure your table to show whatever product data you need.

For example, you can:

  • Create product tables listing products from a specific category, tag or custom field only. (More on this below.)
  • Add filter dropdown lists above the table, or filter widgets in the sidebar. (But remember, you can't filter by custom field because custom fields aren't designed for grouping products. You need to use categories, attributes, tags or custom taxonomies to store filterable data.)
  • Use the lazy load option to speed up the table if you have too many products to load all at once.
  • And much more...

Have a play, and get your product tables and WooCommerce custom fields showing exactly as you need them.

How to dislay WooCommerce custom fields and taxonomies

How to show custom fields on the WooCommerce product page

So far, I've shown you several ways of displaying custom fields on WordPress pages, the shop or product category pages. It's also possible to show WooCommerce custom fields on the single product page (also known as the product detail page).

You can do this using the WooCommerce Product Table plugin that we looked at in the previous section. When used on the single product page, it looks like this:

WooCommerce custom fields taxonomies single product page

A product table displaying custom field data on the WooCommerce product page

For instructions, check out our separate tutorial about How to Display Custom Fields on the WooCommerce Product Page.

How to list WooCommerce products with a specific custom field value

Finally, I'll show you one more option for showing WooCommerce custom fields in the Product Table plugin.

As well as displaying custom fields in the table layout, you can create tables containing products with a specific custom field value.

For example, if you wanted to display products with a custom field value of '2023' (saved in a custom field called 'Year') then you could do it with this shortcode:

[product_table cf="year:2023"]

Another example: Perhaps you have a custom field called ‘condition’ and want to display products with a custom field value of ‘new’. You can do this using the following shortcode:

[product_table cf="condition:new"]


How to create WooCommerce custom fields without a plugin

If you're a developer, then you might be wondering how to add custom fields to a WooCommerce product programmatically. Can you even add custom fields to a WooCommerce product without plugins?

The answer is yes! WooCommerce allows you to programmatically add custom fields to products without installing any additional plugins. However, as you can imagine, the programmatic approach to creating custom fields for WooCommerce products involves programming!

With a programmatic approach, you can add custom information directly to your product metadata. You can also include your custom field(s) as part of the existing WooCommerce product data meta box.

Code sample 1

Your code will depend on the kind of custom fields you're looking to add to your products. Many product types only need a simple custom text field to let users enter some value. For such use cases, this custom text input field snippet by WooCommerce developer Rodolfo Melogli suffices:
code snippet

As you can see, you’ll be using a bunch of core WooCommerce functions and hooks in the code. For example, you're using the WooCommerce hook "woocommerce_before_add_to_cart_button" to show your custom field on your product page. You're also using the woocommerce_add_order_item_meta hook to save your input into the order meta information. These can vary greatly depending on the custom fields you're trying to add.

When you take such input from your users, you should include it in your cart page summary (with your cart item details), your checkout, and also in your order's email. The snippet we just saw doesn't just let you allow your users to enter a text-based value inside your product page but also takes it over to your cart and checkout. Not just that, it adds the custom input to your order confirmation email too.

Code sample 2

Next, we'll share some example code kindly published by Plugin Republic. You'll be adding these snippets to your WordPress child theme's functions.php file. You could use the code snippet below to register a custom field, display the input field in the General tab of the WooCommerce product data box, and save it as product metadata:

/**
* Displays the custom text field input field in the WooCommerce product data meta box
*/
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' );
/**
* Saves the custom field data to product meta data
*/
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 ) );
$product->save();
}
add_action( 'woocommerce_process_product_meta', 'cfwc_save_custom_field' );

Then, you could use WooCommerce's many hooks to display that field data on the front-end of your e-commerce store at the spot where you want it to appear.

For example, this snippet displays the custom field data after the add to cart button on your single product page:

/**
* Displays custom field data after the add to cart button
*/
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 ) {
echo get_post_meta($post->ID, 'custom_text_field_title', true);
}
}
add_action( 'woocommerce_after_add_to_cart_button', 'cfwc_display_custom_field' );

There are also other hooks that let you display information on the WooCommerce checkout page or the cart page.

Is it worth adding custom fields to WooCommerce programmatically?

While you don't need any plugins to programmatically add custom fields to WooCommerce using this method, you can end up with errors. Your custom code could have compatibility issues with the other WooCommerce extensions or WordPress plugins that you might be running. You can also experience code validation errors.

As you can tell, using plugins is a much simpler way to add custom fields to product pages. While it is possible to display custom fields without the use of a plugin, it's really only accessible to developers. That's why the methods described above are a better option for most store owners.


2 easy ways to create and display WooCommerce custom fields

And that's it! I've shown you two easy ways to show custom fields on your website:

  1. We've learned how to add custom product fields to collect extra information from customers. This uses the WooCommerce Product Options plugin.
  2. We also learned how to use a free plugin to store extra data about our products and display them using the WooCommerce Product Table plugin.

Neither method for adding custom fields to WooCommerce products requires any special technical knowledge.

Follow whichever method in this tutorial interests you the most, and put it into practice on your own website. It's a fantastic non-technical way to store and display extra product data in WooCommerce.

Add extra options and flexible add-ons to your WooCommerce products in seconds.
Start showing extra product data on your WooCommerce store today!

35 Comments

  1. Shahid
    April 15, 2022 Reply

    hi, i m facing problem when i m changing currency from PKR(default currency) to USD, only currency symbols are changing not value in custom fields. Like my add on product is for PKR2000 , when i convert the currency into USD , PKR2000 change into USD2000. Please help me fix this issue. thank you

    • Edge
      April 18, 2022 Reply

      Hi, Shahid. Thanks for including a link to an example on your site - I see what you mean. I believe you're using the "pricing hints" feature in the product add-ons created by the Advanced Product Fields for WooCommerce plugin by Studio Wombat on your site. For the best advice regarding your concern, I suggest that you contact Studio Wombat support, or you can use the WooCommerce Product Options plugin featured in this article. I hope this helps point you in the right direction. Please let me know if you have any more questions. Thanks!

Please share your thoughts...

Your email address will not be published.