Skip to content Skip to main navigation Skip to footer

Patron Field Mapping

Patron field numbers are necessary when creating a transaction script or an import document. Use the following table below to determine which field numbers you need for your import. 

FieldHeaderTypeNotes
Barcode1000Import/ExportLimit 15 characters
First Name1007Import/ExportLimit 25 characters
Last Name1006Import/ExportLimit 25 characters
If a patron has multiple last names and you only want to import one, you will need to modify the import file to reflect that.
Middle Name1008Import/ExportLimit 25 characters
Nickname1070Import/ExportLimit 25 characters
Policy1028Import/ExportLimit 4 characters
Uses policy short code as specified in Preferences.
Status1026Import/ExportInteger indicating Status: 1=Active, 2=Card Lost, 3=Suspended, 4=Transferred, 5=Inactive, 6=Other
Government ID *1002Import/ExportTerminology field, often named SSN
Location *1004Import/ExportTerminology field, often named Homeroom
Sublocation *1005Import/ExportTerminology field, often named 2nd Location
Level * (Grade)1010Import/ExportTerminology field, often named Grade
Community ID *1001Import/ExportTerminology field, often named Student #
Site1050Import/ExportSite code as specified in Site Management
Optional Date *1048Import/ExportLimit 12 characters
Terminology field, often named Graduation Date
Address1011Import/ExportLimit 100 characters
Address 288Import/Export
City1012Import/ExportLimit 100 characters
State1013Import/ExportLimit 100 characters
Postal Code1014Import/ExportLimit 100 characters
Country1016Import/ExportLimit 100 characters
Telephone1017Import/ExportLimit 25 characters
Date of Birth1045Import/ExportLimit 12 characters
Sex1032Import/ExportInteger indicating sex or gender: Unspecified=0 or U, Male=1 or M, Female=2 or F
Contact Notes1020Import/ExportLimit 1000 characters
General Notes1021Import/ExportLimit 2000 characters
2nd Phone Number *1018Import/ExportLimit 25 characters
Terminology field, often named Mobile or Fax
Primary Email1019Import/ExportLimit 100 characters
Other Emails1054Import/ExportLimit 100 characters
Categories1025Import/ExportLimit 1000 characters
Separate category terms with \
Patron Accession Date1046Import/ExportLimit 12 characters
Additional Contact *1049Import/ExportLimit 100 characters
Terminology field, often named Parent/Guardian
Username1052Import/ExportLimit 100 characters
Lexile Table1060Import/ExportLimit 300 characters
All grades contained in single string, rows separated by // and cells by II (e.g. Patron ID<tab>//gradeIIscoreIIsourcelldate …repeated as necessary)
Password – Encrypted1063Import/ExportLimit 30 characters
This option is used when importing a password that is already encrypted MD5
Password – Plain TextImport
Card Exp. Date1047Import/ExportLimit 12 characters
Lexile1051Import/ExportLimit 4 characters
Reading Level *1053Import/ExportTerminology preference field
Patron GUID1200Import/ExportLimit 100 characters
Alert Notes1022Export
Pending Holds Count1037Export
In Stock Hold Count1039Export
Reservations Count1038Export
Reserves Count1040Export
Balance (Library)1030Export
Total Payments1031Export
Credits1061Export
Last Use Date1042ExportLimit 12 characters
Life to Date Usage1033Export
Total Currently Out1034Export
Life to Date Overdue1035Export
Currently Overdue1036Export
Patron Barcode3000ExportExport Patrons Fines report, only
Patron Name3001ExportExport Patrons Fines report, only
Type3002ExportExport Patrons Fines report, only
Description3003ExportExport Patrons Fines report, only
Total3004ExportExport Patrons Fines report, only
Charge Balance3005ExportExport Patrons Fines report, only