Phone Number Format Normalizer

WHAT IT DOES

This script scans phone number input fields on any page and adds a button that normalizes the entered number to a consistent format. Choose from E.164 (+1234567890), international (+1 234-567-890), or national (234-567-890) formats. The script can auto-normalize as you type, on blur, or on demand with a single click. It strips non-digit characters, adds country codes, and formats the number with appropriate grouping. The normalized number is automatically filled into the field and copied to your clipboard. Perfect for ensuring phone numbers are stored consistently in forms, CRMs, and databases.

WHERE IT RUNS

The script works on any page with phone number input fields—contact forms, registration pages, checkout forms, CRM systems, and any website that collects phone numbers. It detects inputs by type="tel", name/id/class containing "phone" or "mobile", and text inputs with tel autocomplete.

HOW TO USE

After installation, the script automatically adds a 📞 button next to phone fields on the page. Click the button to normalize the current number—the formatted number is filled into the field and copied to your clipboard. Open the panel to customize: choose output format (E.164, international, national), set default country code, enable auto-normalize on input, normalize on blur, strip non-digit characters, add country code, auto-detect country from page context, and choose button position (inline, right, float). Click "Refresh Buttons" to re-scan after dynamic changes or "Normalize All" to format all phone fields at once.

TECHNICAL MECHANISM

The script uses a multi-stage phone number normalization pipeline. First, it scans the DOM for phone inputs using a comprehensive set of selectors and wraps each in a flex container with a button. Second, it extracts digits from the raw input using regex `/\D/g`, stripping all non-digit characters. Third, it detects the country code by checking if the digits start with a known country prefix or using the configured default. Fourth, it builds the formatted number based on the selected output format: E.164 uses the country prefix plus digits, international adds spaces between groups, national strips the country code and applies grouping. Fifth, it groups digits using a simple 3-3-4 pattern for 10-digit numbers or adaptive grouping for longer numbers. Sixth, it sets the input value using the native setter and dispatches both "input" and "change" events for React/Vue compatibility.

THE PANEL

The settings panel is fully draggable and can be positioned anywhere on your screen. It automatically snaps to the nearest edge when released, keeping your workspace organized. The panel can be collapsed to a small bubble showing only a gear icon, and restored with a single click. Its position is remembered across page reloads using GM_setValue. The panel also responds to the Escape key, which instantly hides it until you click the bubble again. All settings are saved immediately when changed and persist across browser sessions.

PLEASE NOTE

This script requires the free BotGentz extension to run. The script detects phone fields using attribute selectors and may not work on non-standard or custom-built form elements. Country detection is limited to a pre-defined mapping and may not cover all regions. The script does not access, store, or transmit any personal data or phone numbers. All normalization happens locally in your browser and never leaves your device.