[{"data":1,"prerenderedAt":646},["ShallowReactive",2],{"help-article-contacts-custom-fields":3,"help-siblings-contacts":605},{"_path":4,"_dir":5,"_draft":6,"_partial":6,"_locale":7,"title":8,"description":9,"category":5,"order":10,"difficulty":11,"time_to_complete":12,"related":13,"body":17,"_type":599,"_id":600,"_source":601,"_file":602,"_stem":603,"_extension":604},"\u002Fhelp\u002Fcontacts\u002Fcustom-fields","contacts",false,"","Creating custom fields for contacts","How to define custom data fields (text, number, date, select) to store additional contact information.",5,"intermediate","4 minutes",[14,15,16],"\u002Fhelp\u002Fcontacts\u002Fadding-contacts","\u002Fhelp\u002Fcontacts\u002Fcreating-segments","\u002Fhelp\u002Fcontacts\u002Fimporting-contacts",{"type":18,"children":19,"toc":583},"root",[20,28,34,41,52,72,82,100,106,206,212,371,377,384,413,419,424,436,442,453,459,464,482,488,493,499,552,558],{"type":21,"tag":22,"props":23,"children":25},"element","h1",{"id":24},"creating-custom-fields-for-contacts",[26],{"type":27,"value":8},"text",{"type":21,"tag":29,"props":30,"children":31},"p",{},[32],{"type":27,"value":33},"Custom fields let you store any additional data about your contacts beyond the default fields.",{"type":21,"tag":35,"props":36,"children":38},"h2",{"id":37},"default-fields-vs-custom-fields",[39],{"type":27,"value":40},"Default fields vs custom fields",{"type":21,"tag":29,"props":42,"children":43},{},[44,50],{"type":21,"tag":45,"props":46,"children":47},"strong",{},[48],{"type":27,"value":49},"Default fields",{"type":27,"value":51}," (built-in):",{"type":21,"tag":53,"props":54,"children":55},"ul",{},[56,62,67],{"type":21,"tag":57,"props":58,"children":59},"li",{},[60],{"type":27,"value":61},"Name, Phone, Email",{"type":21,"tag":57,"props":63,"children":64},{},[65],{"type":27,"value":66},"Tags, Lifecycle Stage",{"type":21,"tag":57,"props":68,"children":69},{},[70],{"type":27,"value":71},"Assigned Agent, Source",{"type":21,"tag":29,"props":73,"children":74},{},[75,80],{"type":21,"tag":45,"props":76,"children":77},{},[78],{"type":27,"value":79},"Custom fields",{"type":27,"value":81}," (you create):",{"type":21,"tag":53,"props":83,"children":84},{},[85,90,95],{"type":21,"tag":57,"props":86,"children":87},{},[88],{"type":27,"value":89},"Company name, City, Order ID",{"type":21,"tag":57,"props":91,"children":92},{},[93],{"type":27,"value":94},"Subscription plan, Birthday",{"type":21,"tag":57,"props":96,"children":97},{},[98],{"type":27,"value":99},"Any data specific to your business",{"type":21,"tag":35,"props":101,"children":103},{"id":102},"creating-a-custom-field",[104],{"type":27,"value":105},"Creating a custom field",{"type":21,"tag":107,"props":108,"children":109},"ol",{},[110,120,130,197],{"type":21,"tag":57,"props":111,"children":112},{},[113,115],{"type":27,"value":114},"Go to ",{"type":21,"tag":45,"props":116,"children":117},{},[118],{"type":27,"value":119},"Settings → Custom Fields",{"type":21,"tag":57,"props":121,"children":122},{},[123,125],{"type":27,"value":124},"Click ",{"type":21,"tag":45,"props":126,"children":127},{},[128],{"type":27,"value":129},"\"New Field\"",{"type":21,"tag":57,"props":131,"children":132},{},[133,135],{"type":27,"value":134},"Configure:",{"type":21,"tag":53,"props":136,"children":137},{},[138,148,167,177,187],{"type":21,"tag":57,"props":139,"children":140},{},[141,146],{"type":21,"tag":45,"props":142,"children":143},{},[144],{"type":27,"value":145},"Field Name",{"type":27,"value":147}," — Display name (e.g., \"Company Name\")",{"type":21,"tag":57,"props":149,"children":150},{},[151,156,158,165],{"type":21,"tag":45,"props":152,"children":153},{},[154],{"type":27,"value":155},"Field Key",{"type":27,"value":157}," — System key, auto-generated (e.g., ",{"type":21,"tag":159,"props":160,"children":162},"code",{"className":161},[],[163],{"type":27,"value":164},"company_name",{"type":27,"value":166},")",{"type":21,"tag":57,"props":168,"children":169},{},[170,175],{"type":21,"tag":45,"props":171,"children":172},{},[173],{"type":27,"value":174},"Field Type",{"type":27,"value":176}," — Choose the data type",{"type":21,"tag":57,"props":178,"children":179},{},[180,185],{"type":21,"tag":45,"props":181,"children":182},{},[183],{"type":27,"value":184},"Required",{"type":27,"value":186}," — Whether this field must be filled",{"type":21,"tag":57,"props":188,"children":189},{},[190,195],{"type":21,"tag":45,"props":191,"children":192},{},[193],{"type":27,"value":194},"Options",{"type":27,"value":196}," — For Select\u002FMulti-select types, define the choices",{"type":21,"tag":57,"props":198,"children":199},{},[200,201],{"type":27,"value":124},{"type":21,"tag":45,"props":202,"children":203},{},[204],{"type":27,"value":205},"Save",{"type":21,"tag":35,"props":207,"children":209},{"id":208},"field-types",[210],{"type":27,"value":211},"Field types",{"type":21,"tag":213,"props":214,"children":215},"table",{},[216,240],{"type":21,"tag":217,"props":218,"children":219},"thead",{},[220],{"type":21,"tag":221,"props":222,"children":223},"tr",{},[224,230,235],{"type":21,"tag":225,"props":226,"children":227},"th",{},[228],{"type":27,"value":229},"Type",{"type":21,"tag":225,"props":231,"children":232},{},[233],{"type":27,"value":234},"Use for",{"type":21,"tag":225,"props":236,"children":237},{},[238],{"type":27,"value":239},"Example",{"type":21,"tag":241,"props":242,"children":243},"tbody",{},[244,266,287,308,329,350],{"type":21,"tag":221,"props":245,"children":246},{},[247,256,261],{"type":21,"tag":248,"props":249,"children":250},"td",{},[251],{"type":21,"tag":45,"props":252,"children":253},{},[254],{"type":27,"value":255},"Text",{"type":21,"tag":248,"props":257,"children":258},{},[259],{"type":27,"value":260},"Short text values",{"type":21,"tag":248,"props":262,"children":263},{},[264],{"type":27,"value":265},"Company name, City",{"type":21,"tag":221,"props":267,"children":268},{},[269,277,282],{"type":21,"tag":248,"props":270,"children":271},{},[272],{"type":21,"tag":45,"props":273,"children":274},{},[275],{"type":27,"value":276},"Number",{"type":21,"tag":248,"props":278,"children":279},{},[280],{"type":27,"value":281},"Numeric values",{"type":21,"tag":248,"props":283,"children":284},{},[285],{"type":27,"value":286},"Order count, Revenue",{"type":21,"tag":221,"props":288,"children":289},{},[290,298,303],{"type":21,"tag":248,"props":291,"children":292},{},[293],{"type":21,"tag":45,"props":294,"children":295},{},[296],{"type":27,"value":297},"Date",{"type":21,"tag":248,"props":299,"children":300},{},[301],{"type":27,"value":302},"Date values",{"type":21,"tag":248,"props":304,"children":305},{},[306],{"type":27,"value":307},"Birthday, Subscription date",{"type":21,"tag":221,"props":309,"children":310},{},[311,319,324],{"type":21,"tag":248,"props":312,"children":313},{},[314],{"type":21,"tag":45,"props":315,"children":316},{},[317],{"type":27,"value":318},"Boolean",{"type":21,"tag":248,"props":320,"children":321},{},[322],{"type":27,"value":323},"Yes\u002FNo values",{"type":21,"tag":248,"props":325,"children":326},{},[327],{"type":27,"value":328},"Is VIP, Has opted in",{"type":21,"tag":221,"props":330,"children":331},{},[332,340,345],{"type":21,"tag":248,"props":333,"children":334},{},[335],{"type":21,"tag":45,"props":336,"children":337},{},[338],{"type":27,"value":339},"Select",{"type":21,"tag":248,"props":341,"children":342},{},[343],{"type":27,"value":344},"Single choice from options",{"type":21,"tag":248,"props":346,"children":347},{},[348],{"type":27,"value":349},"Plan (Free\u002FGrowth\u002FScale)",{"type":21,"tag":221,"props":351,"children":352},{},[353,361,366],{"type":21,"tag":248,"props":354,"children":355},{},[356],{"type":21,"tag":45,"props":357,"children":358},{},[359],{"type":27,"value":360},"Multi-select",{"type":21,"tag":248,"props":362,"children":363},{},[364],{"type":27,"value":365},"Multiple choices",{"type":21,"tag":248,"props":367,"children":368},{},[369],{"type":27,"value":370},"Interests (Product A, B, C)",{"type":21,"tag":35,"props":372,"children":374},{"id":373},"setting-custom-field-values",[375],{"type":27,"value":376},"Setting custom field values",{"type":21,"tag":378,"props":379,"children":381},"h3",{"id":380},"on-a-contact",[382],{"type":27,"value":383},"On a contact",{"type":21,"tag":107,"props":385,"children":386},{},[387,392,404,409],{"type":21,"tag":57,"props":388,"children":389},{},[390],{"type":27,"value":391},"Open the contact",{"type":21,"tag":57,"props":393,"children":394},{},[395,397,402],{"type":27,"value":396},"Scroll to the ",{"type":21,"tag":45,"props":398,"children":399},{},[400],{"type":27,"value":401},"Custom Fields",{"type":27,"value":403}," section",{"type":21,"tag":57,"props":405,"children":406},{},[407],{"type":27,"value":408},"Click on a field to edit its value",{"type":21,"tag":57,"props":410,"children":411},{},[412],{"type":27,"value":205},{"type":21,"tag":378,"props":414,"children":416},{"id":415},"during-csv-import",[417],{"type":27,"value":418},"During CSV import",{"type":21,"tag":29,"props":420,"children":421},{},[422],{"type":27,"value":423},"Include custom field keys as column headers in your CSV:",{"type":21,"tag":425,"props":426,"children":431},"pre",{"className":427,"code":429,"language":430,"meta":7},[428],"language-csv","phone_number,name,company_name,city,plan\n+919876543210,John Doe,Acme Corp,Mumbai,Growth\n+919876543211,Jane Smith,Tech Inc,Delhi,Scale\n","csv",[432],{"type":21,"tag":159,"props":433,"children":434},{"__ignoreMap":7},[435],{"type":27,"value":429},{"type":21,"tag":378,"props":437,"children":439},{"id":438},"via-api",[440],{"type":27,"value":441},"Via API",{"type":21,"tag":425,"props":443,"children":448},{"className":444,"code":446,"language":447,"meta":7},[445],"language-json","PUT \u002Fapi\u002Fcontacts\u002F{id}\u002Fcustom-fields\n{\n  \"company_name\": \"Acme Corp\",\n  \"city\": \"Mumbai\",\n  \"plan\": \"Growth\"\n}\n","json",[449],{"type":21,"tag":159,"props":450,"children":451},{"__ignoreMap":7},[452],{"type":27,"value":446},{"type":21,"tag":35,"props":454,"children":456},{"id":455},"using-custom-fields-in-segments",[457],{"type":27,"value":458},"Using custom fields in segments",{"type":21,"tag":29,"props":460,"children":461},{},[462],{"type":27,"value":463},"Custom fields can be used as filter conditions:",{"type":21,"tag":53,"props":465,"children":466},{},[467,472,477],{"type":21,"tag":57,"props":468,"children":469},{},[470],{"type":27,"value":471},"\"City equals Mumbai\" → All Mumbai contacts",{"type":21,"tag":57,"props":473,"children":474},{},[475],{"type":27,"value":476},"\"Plan equals Growth\" → All Growth plan customers",{"type":21,"tag":57,"props":478,"children":479},{},[480],{"type":27,"value":481},"\"Birthday is today\" → Birthday greetings campaign",{"type":21,"tag":35,"props":483,"children":485},{"id":484},"using-custom-fields-in-templates",[486],{"type":27,"value":487},"Using custom fields in templates",{"type":21,"tag":29,"props":489,"children":490},{},[491],{"type":27,"value":492},"Reference custom field values in chatbot responses or campaign personalization using the field key.",{"type":21,"tag":35,"props":494,"children":496},{"id":495},"tips",[497],{"type":27,"value":498},"Tips",{"type":21,"tag":107,"props":500,"children":501},{},[502,512,522,532,542],{"type":21,"tag":57,"props":503,"children":504},{},[505,510],{"type":21,"tag":45,"props":506,"children":507},{},[508],{"type":27,"value":509},"Plan ahead",{"type":27,"value":511}," — Define fields before importing data",{"type":21,"tag":57,"props":513,"children":514},{},[515,520],{"type":21,"tag":45,"props":516,"children":517},{},[518],{"type":27,"value":519},"Use Select types",{"type":27,"value":521}," — For fields with limited options (prevents typos)",{"type":21,"tag":57,"props":523,"children":524},{},[525,530],{"type":21,"tag":45,"props":526,"children":527},{},[528],{"type":27,"value":529},"Keep it minimal",{"type":27,"value":531}," — Only create fields you'll actually use for filtering or personalization",{"type":21,"tag":57,"props":533,"children":534},{},[535,540],{"type":21,"tag":45,"props":536,"children":537},{},[538],{"type":27,"value":539},"Consistent naming",{"type":27,"value":541}," — Use snake_case for keys (auto-generated)",{"type":21,"tag":57,"props":543,"children":544},{},[545,550],{"type":21,"tag":45,"props":546,"children":547},{},[548],{"type":27,"value":549},"Order matters",{"type":27,"value":551}," — Set display order to show important fields first",{"type":21,"tag":35,"props":553,"children":555},{"id":554},"limits",[556],{"type":27,"value":557},"Limits",{"type":21,"tag":53,"props":559,"children":560},{},[561,573,578],{"type":21,"tag":57,"props":562,"children":563},{},[564,566,571],{"type":27,"value":565},"Maximum ",{"type":21,"tag":45,"props":567,"children":568},{},[569],{"type":27,"value":570},"50 custom fields",{"type":27,"value":572}," per organization",{"type":21,"tag":57,"props":574,"children":575},{},[576],{"type":27,"value":577},"Text fields: max 500 characters",{"type":21,"tag":57,"props":579,"children":580},{},[581],{"type":27,"value":582},"Select options: max 50 per field",{"title":7,"searchDepth":584,"depth":584,"links":585},2,[586,587,588,589,595,596,597,598],{"id":37,"depth":584,"text":40},{"id":102,"depth":584,"text":105},{"id":208,"depth":584,"text":211},{"id":373,"depth":584,"text":376,"children":590},[591,593,594],{"id":380,"depth":592,"text":383},3,{"id":415,"depth":592,"text":418},{"id":438,"depth":592,"text":441},{"id":455,"depth":584,"text":458},{"id":484,"depth":584,"text":487},{"id":495,"depth":584,"text":498},{"id":554,"depth":584,"text":557},"markdown","content:help:contacts:custom-fields.md","content","help\u002Fcontacts\u002Fcustom-fields.md","help\u002Fcontacts\u002Fcustom-fields","md",[606,609,611,614,617,620,623,625,626,629,631,634,637,640,643],{"_path":607,"title":608},"\u002Fhelp\u002Fcontacts\u002Factivity-timeline","Contact activity timeline explained",{"_path":14,"title":610},"Adding and managing contacts",{"_path":612,"title":613},"\u002Fhelp\u002Fcontacts\u002Fbulk-operations","Bulk operations (assign, tag, delete)",{"_path":615,"title":616},"\u002Fhelp\u002Fcontacts\u002Fcontact-assignment","Contact assignment (to user)",{"_path":618,"title":619},"\u002Fhelp\u002Fcontacts\u002Fcontact-merging","Merging duplicate contacts",{"_path":621,"title":622},"\u002Fhelp\u002Fcontacts\u002Fcontact-pinning","Contact pinning and favorites",{"_path":15,"title":624},"Creating custom segments with filters",{"_path":4,"title":8},{"_path":627,"title":628},"\u002Fhelp\u002Fcontacts\u002Fexporting-contacts","Exporting contacts to CSV",{"_path":16,"title":630},"Importing contacts from CSV",{"_path":632,"title":633},"\u002Fhelp\u002Fcontacts\u002Flifecycle-stages","Contact lifecycle stages (lead to customer)",{"_path":635,"title":636},"\u002Fhelp\u002Fcontacts\u002Fqr-scanner","Using the QR code scanner to add contacts",{"_path":638,"title":639},"\u002Fhelp\u002Fcontacts\u002Fservice-window","Understanding the 24-hour service window",{"_path":641,"title":642},"\u002Fhelp\u002Fcontacts\u002Fsource-tracking","Contact source tracking",{"_path":644,"title":645},"\u002Fhelp\u002Fcontacts\u002Fusing-tags","Using tags to organize contacts",1780423184164]