Custom checkout field recipes

These are ready-made setups for CheckoutWC’s custom checkout fields, for the things stores ask for most. Each one lists the settings to use in the field editor; change the wording and amounts to suit your store. For what every setting does, see Add custom checkout fields.

When you’d use this

  • You want a field working quickly without working out the settings yourself.
  • You want ideas for what custom fields can do for your store.

Before you start

  • Add each field from CheckoutWC » Checkout Editor: expand Slots, click + on the slot named in the recipe, then + New custom field. Click Save Changes when you’re done.
  • A field can’t show or hide based on another field’s answer. Where a recipe has two fields, both show together.

Add-ons that charge a fee

Gift wrapping and a gift message

A checkbox that adds a gift wrap fee, and a text box for the message.

Field 1, in Before Terms & Conditions:

  • Type: Checkbox
  • Label: Gift wrap this order
  • Adds a fee: Fixed amount, 5.00
  • Show the fee in the field label: on, so the label reads “Gift wrap this order (+$5.00)”

Field 2, in the same slot:

  • Type: Text area
  • Label: Gift message (optional)
  • Character limit: 250
  • Required: off

Tip or donation

Let customers add a tip as a percentage of their order, or a donation as a fixed amount.

For a tip, in Before Cart Summary Totals:

  • Type: Radio buttons
  • Label: Add a tip
  • Adds a fee: Percentage
  • Options: No tip (0), 10% (10), 15% (15), 20% (20)
  • Percentage of: Order items after discounts
  • Fee label: Tip

For a donation, use a dropdown with Adds a fee: Fixed amount and options such as “No thanks” (0), “$2” (2) and “$5” (5), with Fee label: Donation. An option with no amount adds no fee.

Information you need from the customer

Delivery instructions

A place for notes to the courier, next to the shipping address. In After Shipping Address, so it only shows on orders that ship:

  • Type: Text area
  • Label: Delivery instructions (optional)
  • Placeholder: e.g. Leave with the neighbor at number 12
  • Character limit: 200

PO number for business customers

In After Billing Address:

  • Type: Text
  • Label: PO number
  • Required: on
  • Display conditions: User Role, At least one of the selected, and the role your business customers have, such as Wholesale customer.

VAT or company registration number

In After Billing Address:

  • Type: Text
  • Label: VAT number (optional)
  • Display conditions: Billing Country, At least one of the selected, and the countries you sell to businesses in

CheckoutWC saves what the customer types; it doesn’t check that a VAT number is valid or change the tax charged. To validate EU VAT numbers and apply the reverse charge, use a dedicated EU VAT plugin; see Overview of support for 3rd party plugins and themes for those CheckoutWC supports.

Engraving or personalization

Shown only when the cart has a product you personalize. In After Cart Summary Items:

  • Type: Text
  • Label: Engraving text
  • Character limit: 30
  • Required: on
  • Adds a fee: Fixed amount, 10.00 (optional)
  • Display conditions: Cart Contents, Contains (Categories), and your engravable products’ category

Customers enter one engraving for the whole order, so this works best when they buy one personalized item at a time.

Agreements and acknowledgements

For a policy customers must accept, in Before Terms & Conditions:

  • Type: Checkbox
  • Label: I’ve read and agree to the returns policy
  • Required: on

For a marketing opt-in, use the same setup with Required off, so customers can choose. A custom field records the answer on the order only. It doesn’t subscribe the customer to your email platform, so use your email plugin’s own checkout opt-in for that.

Age confirmation

Shown only when the cart has age-restricted products. In Before Terms & Conditions:

  • Type: Checkbox
  • Label: I confirm I’m 18 or older
  • Required: on
  • Display conditions: Cart Contents, Contains (Categories), and your age-restricted category

This records the customer’s confirmation. It doesn’t verify their age.

Product warning acknowledgement

For a warning some customers must acknowledge, such as California’s Proposition 65. In Before Terms & Conditions:

  • Type: Checkbox
  • Label: I’ve read the product warning for these items
  • Required: on
  • Display conditions: Shipping Country, At least one of the selected, United States; and Cart Contents, Contains (Categories), and the category that needs the warning

Rules can use the country but not the state, so this shows for every U.S. shipping address.

Common issues

Express checkout orders arrive without a required answer

Express payment buttons can let customers pay before filling in required fields. See A required field was empty on an order paid with express checkout.

A recipe field doesn’t appear

Check its display conditions and its slot. Fields in After Shipping Address don’t show on orders that don’t need shipping. See A field isn’t showing on the checkout.

Keep learning