Guides

Migrating from intl-tel-input

Most options map one-to-one.

intl-tel-input	Devix Phone Input
`intlTelInput(input, options)`	`createPhoneInput(input, options)`
`initialCountry: "auto"` + `geoIpLookup`	`initialCountry: 'auto'` + `lookupCountry` (optional — time zone detection needs no request)
`countryOrder` / `preferredCountries`	`preferredCountries`
`onlyCountries`, `excludeCountries`	same names
`separateDialCode: true`	`separateDialCode: true` (the default)
`strictMode`	`strict` (the default)
`loadUtils` / `utilsScript`	not needed — rules load per country automatically
`iti.getNumber()`	`phone.getNumber()`
`iti.isValidNumber()`	`phone.isValid()`
`iti.getValidationError()` → number	`phone.getValidationReason()` → readable string
`iti.setCountry('gb')`	`phone.setCountry('gb')`
`iti.setNumber('+44…')`	`phone.setNumber('+44…')`
`countrychange` event	`dx:countrychange` event
`hiddenInput: () => ({ phone: 'full' })`	`hiddenInput: 'full'`

jQuery sites

// Before
$('#phone').intlTelInput({ initialCountry: 'ae' });

// After
$('#phone').phoneInput({ initialCountry: 'ae' });

Remove the intl-tel-input CSS, flag sprites and utils.js — none of them are needed.

Updated 12 Sep 2026