International Mobile Number Normalisation

Modified on Fri, 29 Aug at 4:02 AM

Mobile Number Normalisation keeps phone numbers clean and consistent by storing them in international format (with a leading “+” and country dial code). When a number is captured without a country code, we automatically add the correct one. This raises data quality for messaging, segmentation, and analytics by ensuring every record uses a single, reliable format.

How it works

When numbers are captured:

  • Signup/lead forms: If a visitor submits the form with a mobile number without specifying the country code, we detect the user’s country from location data and append the corresponding country code if it’s not already present.
  • API & CSV imports: During API or CSV uploads, if a number has no country code, we append the code from your brand’s country (as selected in your NotifyVisitors account). If the number doesn’t match the brand country’s numbering pattern, we leave it exactly as submitted and don’t add a code. Note: If a number includes a country code that doesn’t match the digit pattern of the number, we store it exactly as provided. We can’t remove or change country codes during import. If any of your numbers have an incorrect country code, please correct them before uploading via API or CSV.

Setting behavior:

  • If enabled: Missing country codes are auto-prepended on create/update across capture points (forms, API, CSV uploads). The feature is not retroactive; existing records are normalised only when they’re re-saved or re-uploaded.
  • If disabled: Numbers are stored exactly as entered. No codes are added or removed.

Where to find it

Mobile Number Normalisation is enabled by default. To turn it off or back on if you’ve previously disabled it, go to Settings → Users, scroll down to Mobile Number Normalisation, and toggle the checkbox. When enabled, it applies globally to all incoming numbers from forms, APIs, and CSV uploads and standardises them automatically. When disabled, numbers are stored exactly as entered.

Examples

InputNormalisationResult
9876543210 (no code)On+91 9876543210 (example: India)
+919876543210 (already included)OnSaved as-is
9876543210OffSaved as-is
CSV with mixed numbersOnCodes added where missing
CSV with mixed numbersOffAll saved as-is

FAQs

 Does it add a “+” sign? 
Yes. Numbers are stored in international format with a leading “+” followed by the country dial code (e.g., +91 9876543210).
 What country code is used?
  • Website/forms: the visitor’s detected country.
  • API/CSV: your brand’s configured country.
 Will it change my existing numbers?
No. Normalisation runs on create and update only. To apply it to existing records, first enable Mobile Number Normalisation, then update those records—either by submitting them again via the API or by re-uploading your list via CSV. The new, normalised values will be applied as those records are reprocessed.
 What if a number looks invalid for that country?
If an invalid country code is present, we still store it as provided; therefore, please correct such numbers before importing.

Was this article helpful?

That’s Great!

Thank you for your feedback

Sorry! We couldn't be helpful

Thank you for your feedback

Let us know how can we improve this article!

Select at least one of the reasons
CAPTCHA verification is required.

Feedback sent

We appreciate your effort and will try to fix the article