Configuring Phone Number Formatting (DisablePhoneAutoFormat)
Configuring Phone Number Formatting (DisablePhoneAutoFormat)
By default, Quik! automatically formats all phone number fields using the US standard format: (###) ###-####. This formatting is applied at the field definition level, which means it affects every phone field in every form — there is no per-field opt-out.
For customers operating in international markets or entering phone numbers that do not conform to a 10-digit US format, this default behavior causes numbers to be truncated or incorrectly reformatted.
The DisablePhoneAutoFormat property allows you to turn off this default formatting across all phone fields at the engine level with a single parameter — no per-field configuration required.
How It Works
When DisablePhoneAutoFormat is set to true in your execute/html request, Quik! will not apply the default US phone formatting to any phone number field. The value you pass in will be rendered exactly as provided.
When the property is omitted or set to false, default US phone formatting is applied as usual. There is no change to behavior for existing integrations that do not use this property.
Configuration
Set DisablePhoneAutoFormat as a parameter in your execute/html call:
POST /rest/quikformsengine/qfe/execute/html
{ "DisablePhoneAutoFormat": true, ... }
|
Property |
Type |
Default |
Description |
|---|---|---|---|
|
|
Boolean |
|
When |
Notes
- This property applies to all phone fields on all forms rendered in the session. It is not configurable on a per-field basis at this level. If you need per-field control, use a Field Rule with the
Formatattribute and leave the attribute value empty to remove formatting from a specific field. - This property is intended for customers with international phone number requirements. US-based customers do not need to use it.
- Backwards compatible — existing integrations that do not pass this property will see no change in behavior.
Related Resources
- Field Rules
- Configuring Field Rules Programmatically (At Run-Time)
- Quik! Field Definition Reference Guide

