Instantly share code, notes, and snippets.

What would you like to do?
Simplify WooCommerce checkout fields for free checkouts
<?php // only copy if needed
* Removes coupon form, order notes, and several billing fields if the checkout doesn't require payment.
* Tutorial:
function sv_free_checkout_fields() {
// first, bail if the cart needs payment, we don't want to do anything
if ( WC()->cart && WC()->cart->needs_payment() ) {
// now continue only if we're at checkout
// is_checkout() was broken as of WC 3.2 in ajax context, double-check for is_ajax
// I would check WOOCOMMERCE_CHECKOUT but testing shows it's not set reliably
if ( function_exists( 'is_checkout' ) && ( is_checkout() || is_ajax() ) ) {
// remove coupon forms since why would you want a coupon for a free cart??
remove_action( 'woocommerce_before_checkout_form', 'woocommerce_checkout_coupon_form', 10 );
// Remove the "Additional Info" order notes
add_filter( 'woocommerce_enable_order_notes_field', '__return_false' );
// Unset the fields we don't want in a free checkout
function unset_unwanted_checkout_fields( $fields ) {
// add or remove billing fields you do not want
// fields:
$billing_keys = array(
// unset each of those unwanted fields
foreach( $billing_keys as $key ) {
unset( $fields['billing'][ $key ] );
return $fields;
add_filter( 'woocommerce_checkout_fields', 'unset_unwanted_checkout_fields' );
add_action( 'wp', 'sv_free_checkout_fields' );

This comment has been minimized.


bekarice commented Sep 2, 2015

Noticed there is one case this doesn't hold: If there's a signup fee but a free subscription, the fields also disappear, which we don't want since payment is due. Insert this after line 13 (the first check to bail out) to account for this scenario if you use free subscriptions with signup fees:

// Subscriptions check: bail Subs is active and we have an initial payment to charge
if ( class_exists( 'WC_Subscriptions' ) ) {
    $cart = WC()->cart;
    $cart_total = WC()->cart->total;

    if ( WC_Subscriptions_Cart::calculate_subscription_totals( $cart_total, $cart ) ) {

final note: I don't really check comments here, just leaving this one since I don't want to update the main gist as this won't apply to most people.


This comment has been minimized.

markob17 commented Oct 14, 2016

Hi Beka,

Thank you for the great code snippet. Do you have any idea how to not hide the fields when a subscription with a free trial is involved? I found this is another case where this doesn't hold. Woocommerce still hides the fields because it sees a subtotal of $0 because of the free subscription trial period.




This comment has been minimized.

BenLinders commented Oct 29, 2017

Hi Beka,

I've been using this code snippet long time to allow customers to download free articles

But now I see that when I use the snippet, woocommerce gives an error message that billing country, street/address, etc is required.

Has something changed in woocommerce that makes it fail?

Ben LInders


This comment has been minimized.

em-piguet commented Dec 21, 2017

Hi there, same problem here. I get errors on fields i have unset().. Any advice ?


This comment has been minimized.

merridennis commented Jan 1, 2018


This comment has been minimized.

glasgowshipyard commented Feb 20, 2018

Hello! Seems this no longer works with woocommerce 3.3. unset fields are still required.


This comment has been minimized.

wosc commented Sep 16, 2018

I'm running woocommerce 3.4, and as noted above, while the fields are properly omitted from the form, one then gets "field billing city is required" etc. errors when submitting the form. I solved this by modifying the main condition to include not only is_checkout but also is_ajax, as described here:

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment