Errors and Solutions

This guide contains the most common errors when using the WPify Woo Phone Validation plugin and steps to resolve them.

Phone Number Validation Errors

Please enter a valid phone number

Cause: The entered phone number does not match a valid format for the selected country.

Solution:

1. Check that the correct country (flag) is selected next to the phone field
2. Enter the number in the correct format for the given country (e.g., 607 123 456 for CZ)
3. If entering a number with an international dial code (e.g., +420), make sure the code matches the selected country

Please enter a valid mobile phone number

Cause: The Mobile Numbers Only option is enabled in the plugin settings and the entered number is a landline.

Solution:

1. Enter a mobile phone number instead of a landline number
2. If you want to allow landline numbers as well, disable the Mobile Numbers Only option in the plugin settings (General Settings tab)

Please enter phone number

Cause: The phone field is required and was left empty.

Solution:

1. Fill in the phone number in the respective field
2. If the phone field should not be required, adjust the field settings in WooCommerce

Checkout Errors

Validation error appears even though the number is correct

Cause: The plugin may not have correctly detected the country or the number format is non-standard.

Solution:

1. Try entering the number in full international format (e.g., +420607123456)
2. Check that the correct country is selected next to the phone field
3. Verify that you don’t have a browser extension blocking JavaScript
4. Try refreshing the checkout page and entering the number again

Phone field does not display with country selector (flag)

Cause: The plugin’s JavaScript did not load correctly.

Solution:

1. Check the browser console (F12 → Console) and look for JavaScript errors
2. Verify that there is no conflict with another plugin that modifies the phone field
3. Try disabling cache plugins and refreshing the page
4. Verify that the plugin is active and the license is valid

Validation does not work in block checkout

Cause: Block checkout requires WooCommerce Blocks and specific integration.

Solution:

1. Update the plugin to the latest version
2. Verify that WooCommerce and WooCommerce Blocks are up to date
3. Try clearing the browser cache
4. Check the browser console for any errors

Settings Issues

Settings changes are not taking effect

Cause: Browser cache or caching plugins may be serving an old version of the page.

Solution:

1. Save the plugin settings again
2. Clear the browser cache (Ctrl+Shift+Delete)
3. If you use a caching plugin (WP Super Cache, W3 Total Cache, etc.), clear its cache
4. Check if you have a CDN that caches JavaScript files

Automatic country detection does not work

Cause: GeoIP detection requires a properly functioning geolocation service.

Solution:

1. Verify that you have the Automatic Country Detection option enabled in the settings
2. Check whether your hosting supports GeoIP
3. GeoIP detection does not work on localhost and in some development environments
4. Try opening the page in an incognito browser window

Form Issues

Validation does not work on a custom form

Cause: The plugin did not detect the phone field in the form.

Solution:

1. Check that you have correctly filled in the Phone Field IDs in the settings (General Form Support tab)
2. The field ID must match the id or name attribute of the HTML <input> element
3. If you are using page restrictions, verify that the form is on an allowed page

International format is not saved in the form

Cause: Auto-formatting is not enabled for general forms.

Solution:

1. In the plugin settings (General Form Support tab), enable the Auto-format to International Format option
2. Save the settings and clear the cache

Frequently Asked Questions (FAQ)

What phone number format does the plugin store?

The plugin stores phone numbers in E.164 format — an international format without spaces or special characters, including the country dial code. For example, the Czech number 607 123 456 is stored as +420607123456.

This behavior can be adjusted using the Save International Format in Orders and Save International Format in User Profiles settings in the WooCommerce tab.

Does the plugin work with both classic and block checkout?

Yes, the plugin supports both WooCommerce checkout variants — classic (shortcode) and block (Checkout Block). Features are comparable; the block checkout additionally supports shipping phone validation.

Can I restrict input to mobile numbers only?

Yes, in the plugin settings (General Settings tab), enable the Mobile Numbers Only option. The plugin will then reject landline numbers and display the message “Please enter a valid mobile phone number”.

How do I add phone validation to a custom form outside WooCommerce?

In the plugin settings, go to the General Form Support tab. Enter the phone field IDs (CSS selectors) and optionally restrict loading to specific pages. The plugin will then automatically add validation and country selection to the specified fields.

The plugin conflicts with another plugin that modifies the phone field

Solution:

1. Identify the conflicting plugin (deactivate other plugins and test)
2. Check the browser console (F12) for JavaScript errors
3. If both plugins modify the same field, keep only one active
4. If needed, contact support at support@wpify.io