ThemeHigh
  • Plugins
  • Bundles
  • Resources
    Documentation Documentation Step-by-step guides to set up and help you understand our plugins with ease. Blog Blog Tips, insights, and ideas from the team to help you grow your e-commerce store.
  • Resources
    Documentation
    Documentation

    Step-by-step guides to set up and help you understand our plugins with ease.

    Blog
    Blog

    Tips, insights, and ideas from the team to help you grow your e-commerce store.

  • Support
  • Login
  • Getting Started
    • Plugin Installation
    • Overview
    • Date, Time & Related Field Settings
    • Import/Export Checkout Fields
    • Managing Checkout Fields
    • Managing Checkout Section
    • Set Display Rules
    • Set Repeat Rules
    • Price Fields & Types
    • User Meta Data & Order Meta Data
    • Display Custom Fields
  • Classic and Block Checkout Editor
    • Classic and Block Checkout Editor
    • Why Your Checkout Fields Aren’...
  • Block Checkout Field Editor
    • Block Checkout Field Editor
  • Advanced Settings
    • Custom Fields in Address Format
    • Enable Address Autofill
    • Configure Locale Override Settings
    • Add Custom Fields to CSV Export
    • Display Custom Fields In PDF Invoices & Packing Slips
    • Zapier Support
    • Country, State, Province based Conditions
    • WPML Compatibility
    • Backup & Import Settings
    • Enhanced Select (Select2) for Select Fields
    • Enable Wrap Custom Sections with Div
    • Enable Heading/Label Field
    • Enable Review Panel Conditions
    • Enable Inline Validation in Chec...
    • Enable Conditional Rules Based Payment & Shipping Methods
    • WPML String Translations...
    • Add a New Custom Validation Rule
    • Add a New Confirm Field Validator
  • For Developers
    • Hooks & References...
    • Display Rules: Use cases and mor...
    • Repeat Rules: More use cases and...
    • Based on Checkout Fields: Use ca...
    • Override HTML Content: Examples...
    • Compatibility with “WooCom...
  • Compatible Plugin & Themes
    • Plugins & Themes...
  • Frequently Asked Questions
    • Frequently Asked Questions...
  • How
    • How To Display Fields In Order D...
    • How To Customise The Shipping Se...
    • How To Add Custom Fields In The ...
    • How to Add Custom Price Fields o...
    • How To Add A New Section To The ...
    • How To Display Custom Fields In ...
    • How to Show/Hide Fields Based On...
    • How To Set Repeat Rules On The C...

Documentation/Checkout Field Editor for WooCommerce/How to Add a New Confirm Field Validator?

How to Add a New Confirm Field Validator?

Last updated on June 15, 2026

When customers type sensitive information at checkout — like an email address or a custom account number — a single typo can cause real problems: failed order confirmations, missed communications, or incorrect records that are difficult to trace back and fix.

The Confirm Field Validator feature in Checkout Field Editor for WooCommerce solves this by letting you require customers to enter the same value twice and automatically checking that both entries match before the order is placed. It’s a simple but effective way to catch input errors at the source.

What Is a Confirm Field Validator?

A confirm field validator is a rule that compares the value of one checkout field against the value of another. If they don’t match, the customer sees a validation error and cannot proceed until the values are identical.

Like custom validators, confirm validators are configured once in Advanced Settings and then appear in the Validations dropdown when creating or editing a checkout field. You assign the validator to the confirmation field — not the original field.

Each confirm validator has four parts:

 

Field Description
Validator Name A unique internal identifier for this rule (e.g., confirm_email_validator). Not visible to customers.
Validator Label The display name shown in the Validations dropdown (e.g., “Retype email”).
Field Name The name of the original field whose value this field must match. For example, to confirm the billing email, enter billing_email.
Validator Message The error message shown if the values don’t match. Use %s to include the field name. Example: %s Email Mismatch.

How to Create a Confirm Field Validator

  1. Go to WooCommerce → Checkout Form → Advanced Settings.
  2. Scroll to the Custom Validators section.
  3. Fill in the four fields in the Confirm field validators row.
  4. To add more confirm validators, click the + button. To remove one, click the × button.
  5. Click Save Changes.
  6. Open the confirmation field in the field editor (e.g., your Confirm Email field) and select the newly created validator from its Validations dropdown.

Use Case: Preventing Email Typos at Checkout

Order confirmation emails are one of the most critical touchpoints in the post-purchase experience. If a customer miskeys their email address — transposing two letters, for instance — they won’t receive the confirmation, shipping updates, or invoice. By the time they contact support, the order may already be fulfilled to an address they can’t access.

Adding a Confirm Email field paired with a confirm field validator eliminates this risk entirely. The customer must type their email address twice, and if the entries don’t match, they see a message like “Email mismatch”. The order cannot be placed until both fields are identical, ensuring your store always has a valid, intentionally entered email address on record.

This same approach works for any field where accuracy matters: a custom account number, a referral code, or a VAT registration number.

Important: Confirm field validators only trigger when the confirmation field contains a value. To ensure the validation always runs without exception, mark the confirmation field as Required in its field settings. Without this, a customer could leave the confirmation field empty and bypass the check entirely.

Note :In our Checkout Field Editor plugin, the confirm field validation is triggered only when the customer clicks the Place Order button during checkout.

Get the plugin

On this page

  • What Is a Confirm Field Validator?
  • How to Create a Confirm Field Validator

What's new

  • Added a custom file upload button property for the File upload field type.
  • Alert on selecting display position of sections as before/after terms and conditions.
  • Added Woocommerce 6.8.2 compatibility.

Highlights

  • 24 custom field types with file upload.
  • Create additional sections.
  • Display sections and Fields Conditionally.
  • Display custom fields at 14 different positions.
  • Create confirm field validators.
  • Price fields with a set of price types.
  • Repeat fields and sections based on specific conditions.
  • WPML Compatibility.
  • Import & Export fields and sections.

This article posted in Advanced Settings, Checkout Field Editor for WooCommerce, Pro Documentation

Leave a Reply Cancel reply

Your email address will not be published. Required fields are marked *

ThemeHigh

Driven by a deep passion for crafting thoughtful solutions, we aim to make WooCommerce store customization an easy and enjoyable experience for our users.

© 2026 ThemeHigh. All rights reserved.

Terms and conditions, features, support, pricing, and service options subject to change without notice.