Change CheckoutWC text and labels

You can reword most of the text on the CheckoutWC checkout. Some of it has a setting; the rest can be changed by a developer with a short snippet. To translate CheckoutWC into another language instead, see Translate CheckoutWC.

When you’d use this

  • A button or link doesn’t match your store’s tone, for example “Complete Order” instead of “Place order”.
  • You want the promo code field to say “discount code” or “gift card”.
  • You want a different message when shipping is free, needs an address or isn’t available.
  • You want to rename the Information heading or a step in the breadcrumb.

Text you can change without code

  • Mobile cart summary link: Cart Summary Mobile Label under CheckoutWC » Pages » Checkout » Mobile Options, or in the Checkout Editor.
  • Footer: Footer Text on the Design tab of CheckoutWC » Appearance, or in the Checkout Editor.
  • Side cart: the suggested products Heading, and each rewards bar tier’s Short label, Unlocked message and Locked message, on CheckoutWC » Side Cart.
  • Local pickup: the pickup and shipping option labels on CheckoutWC » Local Pickup.
  • Trust badges, store policies, custom fields, order bumps and cart recovery emails: their text is set where you create them.

Where to add these snippets

The snippets below need a developer. Add them in the PHP Snippets box (CheckoutWC » Advanced, Scripts tab), a code snippets plugin or your child theme’s functions.php, and change the quoted text to your own.

Continue and return buttons

add_filter( 'cfw_continue_to_shipping_method_label', function () {
    return 'Next: shipping';
} );
add_filter( 'cfw_continue_to_payment_method_label', function () {
    return 'Next: payment';
} );
add_filter( 'cfw_return_to_customer_info_label', function () {
    return 'Back to your details';
} );
add_filter( 'cfw_return_to_shipping_method_label', function () {
    return 'Back to shipping';
} );

The defaults are “Continue to shipping”, “Continue to payment” (or “Review order” when the order needs no payment), “Return to information” and “Return to shipping”. With the order review step on, cfw_continue_to_order_review_label changes “Review order”, and cfw_return_to_payment_method_label changes “Return to payment”.

Place order button

add_filter( 'woocommerce_order_button_text', function () {
    return 'Place order';
}, 999 );

The default is “Complete Order”. Some payment gateways set their own button text, such as “Proceed to PayPal”, which replaces this when the customer picks that gateway. To change a gateway’s text, use cfw_gateway_order_button_text, which also receives the gateway.

add_filter( 'cfw_return_to_cart_link_text', function () {
    return 'Back to cart';
} );
add_filter( 'cfw_return_to_cart_link_url', function () {
    return home_url( '/shop/' );
} );

The defaults are “Return to cart” and your cart page.

Promo codes and shipping

Promo code field

add_filter( 'cfw_promo_code_label', function () {
    return 'Discount code';
} );
add_filter( 'cfw_promo_code_placeholder', function () {
    return 'Enter discount code';
} );
add_filter( 'cfw_promo_code_apply_button_label', function () {
    return 'Use code';
} );
add_filter( 'cfw_promo_code_toggle_link_text', function () {
    return 'Have a discount code?';
} );

The defaults are “Promo Code”, “Enter Promo Code”, “Apply” and “Have a promo code? Click here.”

Free shipping label

add_filter( 'cfw_shipping_free_text', function () {
    return 'Free shipping';
} );

The default is WooCommerce’s “Free!”.

Shipping messages

Two messages cover the shipping total when there’s nothing to show yet.

To change the message customers see before they’ve entered an address:

add_filter( 'cfw_shipping_total_address_required_text', function () {
    return 'Enter your address to see shipping options';
} );

The default is “Enter your address to view shipping options.” on the checkout and “Shipping costs are calculated during checkout.” in the side cart. The filter applies to both.

To change the message when an address has been entered but no shipping method is available for it:

add_filter( 'cfw_shipping_total_not_available_text', function () {
    return 'No shipping options for this address';
} );

The default is “No shipping methods available”.

Cart summary and account

On phones, the collapsed cart summary has a “Show order summary” link. Set Cart Summary Mobile Label (see Text you can change without code), or use cfw_show_order_summary_link_text when that setting is empty. cfw_show_order_summary_hide_link_text changes “Hide order summary”.

Create account checkbox label

The checkbox reads “Create [site name] shopping account.” To change the site name in it:

add_filter( 'cfw_create_account_site_name', function () {
    return 'My Store';
} );

To change the whole label, use cfw_create_account_checkbox_label.

Step names and section headings

CheckoutWC has no setting for its headings, so a short snippet renames them. Add it as described in Where to add these snippets. Each filter receives the current text and returns the text you want. This example renames the first step and its heading, and the two address headings:

add_filter( 'cfw_breadcrumb_customer_info_label', function () {
    return 'Contact';
} );
add_filter( 'cfw_customer_information_heading', function () {
    return 'Contact details';
} );
add_filter( 'cfw_shipping_address_heading', function () {
    return 'Delivery address';
} );
add_filter( 'cfw_billing_address_heading', function () {
    return 'Invoice address';
} );

Here’s what each filter changes, with the default text in parentheses.

Filter What it changes
cfw_breadcrumb_customer_info_label The first step’s name in the breadcrumb (“Information”)
cfw_breadcrumb_shipping_label The second step’s name in the breadcrumb (“Shipping”)
cfw_breadcrumb_payment_label The last step’s name in the breadcrumb (“Payment”, or “Review” when the order needs no payment)
cfw_customer_information_heading The heading at the top of the first step (“Information”)
cfw_shipping_address_heading The heading above the address form when the order ships (“Shipping address”)
cfw_billing_shipping_address_heading That heading when WooCommerce is set to ship only to the billing address (“Billing and Shipping address”)
cfw_billing_address_heading The billing address heading on the payment step, and the address form heading when the order doesn’t ship (“Billing address”)
cfw_shipping_method_heading The heading above the shipping methods (“Shipping method”)
cfw_payment_method_heading The heading above the payment methods (“Payment”)

The breadcrumb names and the headings are separate, so change both to keep them matching. A snippet replaces the text in every language; see My new text shows in every language.

Common issues

The place order button text doesn’t change

A payment gateway is setting its own text, which replaces yours when the customer selects it. Use cfw_gateway_order_button_text for that gateway.

My new text shows in every language

A snippet replaces the text for every visitor, whatever their language. On a multilingual store, change the wording through translation instead, so each language gets its own; see Translate CheckoutWC.

Keep learning