Skip to main content

Customer Fields: Add Custom Fields to Contacts

Laifaxin ships with default contact fields (name / email / company / phone, etc.). Defaults not enough? Build your own โ€” e.g. "Customer Budget / Decision Cycle / Preferred Channel" โ€” just create the matching field.

๐ŸŽฏ Field vs. Tag: how to choose
  • ๐Ÿ“„ Field โ€” used to record specific info (e.g. "Customer Budget = 5000 USD")
  • ๐Ÿท๏ธ Tag โ€” used to classify customers (e.g. "High-budget customer")

โ†’ Data with a concrete value โ†’ field; just needs classification โ†’ tag. The two are complementary.

Entry: Settings โ†’ Customer Fields

Settings ยท Customer Fields entry: "Customer Fields" item in the settings left menu


1. What are fields? How are they used?โ€‹

Example: contact John has "Gender = Male", "Age = 30" โ€” here "Gender" and "Age" are fields.

Laifaxin ships with default fields (name / email / company / country / phone). If they're not enough, create custom fields.

The field management backend supports add / edit / delete:

Customer Fields management ยท Overview: default + custom fields mixed list โ€” each row has field name / creator / scope / type


2. Create custom fields (incl. 5 types)โ€‹

1. Field list overviewโ€‹

The list has 4 columns:

ColumnMeaning
NameField name (e.g. "Country / Customer Budget")
CreatorSystem fields show system; custom fields show custom
ScopeContact / Company (different scopes mean different field sets)
Type1 of 5 (single-line text / multi-line text / option / date / number)

Field management list: each row shows field name / creator (system / custom) / scope (contact / company) / type

2. Walkthrough: create a "Country" fieldโ€‹

3 steps:

โ‘  Click Newโ€‹

The ใ€+ Newใ€‘ button in the top-right:

Field management ยท New button: click to open new-field form

โ‘ก Configure 3 core attributesโ€‹

AttributeExample
NameCountry
ScopeContact (required) โš ๏ธ "Company" scope isn't active yet
TypeSingle-line text

New field config modal: name + scope + type โ€” 3 required choices

โ‘ข Pick the right field typeโ€‹

Laifaxin supports 5 field types:

TypeUseExample
๐Ÿ“ Single-line textShort text / flexible inputCountry / City / WeChat ID
๐Ÿ“„ Multi-line textLong text / descriptionsCustomer notes / detailed requirements
๐Ÿ”˜ OptionFixed options (single / multi)Customer level (A/B/C) / Lead source
๐Ÿ“… DateDate pickerFirst-contact date / follow-up deadline
๐Ÿ”ข NumberPure numbersCustomer budget / headcount / annual revenue

Field type picker: 5 types in dropdown (single-line text / multi-line text / option / date / number)

For "Option" type, configure 2 more:

  • โ˜‘๏ธ Allow multi-select: toggle single vs. multi (e.g. "Lead source" usually single; "Tags"-style multi)
  • ๐Ÿ“ Options: enumerate all values (e.g. Lead source = Trade show / Website / Referral / Cold email)

Option type settings: multi-select toggle + options list, add values one by one

3. Verify after creationโ€‹

Successfully created โ€” the field appears in the list with Creator showing custom:

New field verification: "Country" field appears in the list, Creator column labeled custom


3. Control field display and orderโ€‹

After creation, fields don't auto-show in the New Contact form or contacts list. Manually add them in 2 places.

1. Show in "New Contact" formโ€‹

Want Country visible when creating a new contact?

Steps:

  • Open New Contact โ†’ click ใ€Customize Display Fieldsใ€‘

New Contact ยท Customize Display Fields entry: button at top-right

  • In the modal, drag "Country" from left available list to right shown list โ†’ save

Customize Display Fields modal: pick from left available โ†’ moves to right shown list + save button

Done โ€” the New Contact form now has a "Country" field:

New Contact ยท Country field now shown: form has editable "Country" input alongside default fields

2. Show in "Contacts list"โ€‹

Want to see the customer's "Country" directly in the contacts list?

โ‘  Check current default columnsโ€‹

Look at default columns:

Contacts list ยท Default columns: default columns shown (e.g. name / email / company / country / tags)

โ‘ก Open display settingsโ€‹

Top-right of the list โ†’ ใ€Data Opsใ€‘ โ†’ ใ€Edit Fieldsใ€‘:

Contacts list ยท Edit Fields entry: "Edit Fields" in the top-right "Data Ops" dropdown

โ‘ข Remove unneeded columnsโ€‹

Click the ใ€ร—ใ€‘ on the right of a field to remove (e.g. Company / First Name / Last Name / Gender / Birthday):

Edit list display fields ยท Remove: click ร— on the right to remove unneeded fields, avoid over-wide list

After removal, 8 core columns remain (name / verification result / tags / homepage / nickname / source / scope / email):

After removal: trimmed to 8 core columns

Save and the list looks like:

After save: column widths sensible, every column useful, no horizontal scroll

โ‘ฃ Add new columnsโ€‹

In the left available-fields list, check what you want to add (e.g. "Rating + Country") โ€” they auto-move to the right shown list:

Edit display fields ยท Add: check "Rating / Country" on left, added to right shown list

โ‘ค Reorder fieldsโ€‹

Want "Rating" before "Homepage"? Drag to the target position:

Edit display fields ยท Drag-sort: drag a field to adjust column order

Confirm position is correct, click ใ€Saveใ€‘:

Order confirmation: Rating now sits before Homepage as expected

After save, the list updates:

Final list: Rating column appears before Homepage, in your custom order

3. Show in "Edit Contact" formโ€‹

Same as Show in New Contact form. The "Customize Display Fields" entry on the Edit Contact modal works identically.


๐Ÿ“‹ Pitfalls to avoidโ€‹

PitfallConsequenceHow to avoid
๐Ÿ”ด Deleted a custom field by mistakeAll customer data under that field is lost (irreversible)Before deleting, export a backup, confirm no customer is using it
๐Ÿ”ด Picked "Company" scopeCompany-scope fields aren't active yetPick "Contact" scope for everything until the company-scope feature ships
๐ŸŸก Too many fieldsContact UI lags + heavy data entryPrioritize necessary fields โ€” keep total โ‰ค 20 custom fields
๐ŸŸก Wrong field typeCan't filter precisely later (e.g. "Annual revenue" as text can't do > / < filters)Use Number / Date for numeric types; only use single/multi-line text for text
๐ŸŸก Created a field but didn't add to displayField exists but invisible in UIAfter creating, manually add via ใ€Customize Display Fieldsใ€‘ / ใ€Edit Fieldsใ€‘
๐ŸŸก Renaming options laterHistory data displays inconsistentlyDon't rename options frequently after creation โ€” adding is fine, deleting requires care

โ“ FAQโ€‹

Q1 ยท Field vs. tag?โ€‹

Dimension๐Ÿ“„ Field๐Ÿท๏ธ Tag
PurposeRecord specific values (e.g. Customer Budget = 5000)Classify customers (e.g. "High-budget customer")
Data type5 types (text / option / date / number)Just a name (with color)
Filter usageField value > / < / equals / containsContains tag / doesn't contain tag
QuantityGood for 5โ€“20 core fieldsGood for 50โ€“200 classification tags
Typical use"Customer budget / decision cycle / headcount""VIP / Inquiry / Closed"

โ†’ Use together: fields store values + tags classify.

Q2 ยท Is there a custom field limit?โ€‹

No hard limit, but build reasonably. We recommend โ‰ค 20 custom fields for the best experience โ€” more than that hurts data entry and UI performance.

Q3 ยท When does "Company" scope become active?โ€‹

In the current version, "Company" scope is reserved for future features. Watch Laifaxin's website for the announcement. For now pick "Contact" scope for everything.

Q4 ยท Can I recover data after deleting a field by mistake?โ€‹

โš ๏ธ No. Field deletion is irreversible โ€” all customer data tied to it is lost. Before deleting:

  • Export a backup of all contacts
  • Confirm no customer is using the field
  • Confirm again in the second-confirmation modal

Q5 ยท Can I batch-edit custom field values?โ€‹

โœ… Yes. Open Contacts โ†’ check multiple customers โ†’ ใ€Batch Operations โ†’ Edit Fieldใ€‘. See ๐Ÿ“š Batch Management ยท Edit Field.

Q6 ยท Can I drag-reorder fields?โ€‹

โœ… Yes โ€” 2 ways:

  • In the ใ€Customize Display Fieldsใ€‘ modal, drag the โ ฟ icon
  • In the contacts list, drag column headers left/right

๐Ÿ’ก Study tipsโ€‹

StageAdvice
๐ŸŽฏ Plan before buildingBefore creating, map business needs โ€” list what truly needs to be tracked ("Customer budget / decision-maker role / industry") to avoid clutter
โœ‚๏ธ Stay leanMore fields is not better โ€” only build what actually adds value for marketing / service. โ‰ค 20 is best
๐Ÿ”„ Periodic reviewQuarterly review: unused fields โ†’ delete, new needs โ†’ add โ€” keep the library clean
๐Ÿค Team alignmentIn team mode, align on field meaning and use to avoid inconsistent entries
๐Ÿ“Š Pair with tags + viewsFields record specific values + tags classify + views filter โ€” 3-piece set for precision
๐Ÿ”ข Use the right number typesRevenue / budget โ†’ Number for >5000 filters; don't lazily use single-line text

TopicLinkDescription
๐Ÿ“‹ Manage Contactsmanage-contactsFill field values in contact details
โž• Add Contactsadd-contactsMap custom fields during bulk import
๐Ÿท๏ธ Tag Managementtag-managementFields store values, tags classify โ€” complementary
๐Ÿท๏ธ Tags & Viewscontacts-tags-viewsField + tag + view trio for precise filtering
๐Ÿ“ Email Templatesemail-templatesUse {custom_field} variables in templates for personalization

Permalink: https://laifa.xin/zhinan/customer-fields