Connector Import Field Length Limits

Overview of the maximum character lengths for import fields in connector templates.

11.06.2026

PUBLIC

The following tables list the maximum character lengths for all fields that can be used in connector import templates (user import, phonebook/contact import, speeddial import).

Phonebook / Contact Fields

Field Template Variable Max Length
Display Name 028pho_bez 80
First Name 028pho_firstname 80
Last Name 028pho_lastname 80
Organisation 028pho_organisation 80
Phone (business) 028pho_phone 45
Phone (private) 028pho_phone_res 45
Email 028pho_email 150
Mobile (business) 028pho_mobile 45
Mobile (private) 028pho_mobile_res 45
Home Phone 028pho_homephone 45
Home Phone (private) 028pho_homephone_res 45
Fax (business) 028pho_fax 45
Fax (private) 028pho_fax_res 45
Notes 028pho_notes unlimited

Phone number fields additionally only accept digits (max 25) with an optional leading +.

User / Identity Fields

Field Template Variable Max Length
Display Name 003use_bez 45
Username (Login) 003use_name 100
Email 003use_email 150
Extension 009ext_extension 10
PIN 011acc_pin 150
Voicemail Email 016voi_email 150

Device Fields (IP Phone via User Import)

Field Template Variable Max Length
Device Name 010dev_bez 80
Device Display Name 010dev_caption 80
MAC Address 071ipp_mac 12
Auth User 071ipp_authuser 45
Auth Password 071ipp_authpass 250

Mobile Pairing (via User Import)

Field Template Variable Max Length
Mobile Number 072mob_number 45

Speed Dial Fields

Field Template Variable Max Length
Name 042spe_bez 45
Target Number 042spe_target 45
Important Note: If imported data exceeds these limits, the connector import will fail for the affected record. The most common issue is the user display name (003use_bez) which is limited to only 45 characters — shorter than the phonebook display name (80 characters).