Custom Fields Guide

Learn how to create and use custom fields to track unique information specific to your business needs.

What are Custom Fields?

Custom fields let you capture and store information beyond the standard lead fields. Add any data relevant to your business:

Standard fields (built-in):

• First Name, Last Name
• Email, Phone
• Company, Job Title
• Status, Source, Type

Custom fields (you create):

• Budget Range
• Current CRM
• Number of Employees
• Annual Contract Value
• Industry Segment
• Product Interest
• Referral Source
• Anything else you need!

Why Use Custom Fields?

Capture What Matters to YOUR Business

• Every business is unique
• Track qualification criteria
• Store decision-making factors
• Record specific needs

Better Qualification

• Score leads based on custom data
• Filter by custom criteria
• Identify best-fit prospects

Improved Reporting

• Analyze custom metrics
• Track what drives conversions
• Make data-driven decisions

Personalized Outreach

• Reference custom field data in emails
• Tailor pitch to specific needs
• Show you understand their situation

Creating Custom Fields

Step-by-Step

1. Navigate to Settings → Company → Custom Fields
2. Click + Add Custom Field
3. Configure the field:

1. Click Create Field

Field Types

Choose the right type for your data:

Text (Short)

• Single line of text
• Max 255 characters
• Use for: Job title, product name, referral name

Text (Long)

• Multiple lines
• Unlimited length
• Use for: Notes, descriptions, comments

Number

• Numeric values only
• Can set min/max
• Use for: Budget, employee count, deal size

Currency

• Number with currency symbol
• Formatted as money
• Use for: Budget, deal value, annual spend

Dropdown (Single Select)

• Choose one option from list
• Predefined options
• Use for: Industry, company size, product interest

Dropdown (Multi-Select)

• Choose multiple options
• Checkboxes
• Use for: Products interested in, pain points

Date

• Calendar date picker
• Format: MM/DD/YYYY
• Use for: Decision date, contract renewal, next meeting

Date & Time

• Date + time picker
• Use for: Demo scheduled, follow-up time

Checkbox

• Yes/No toggle
• Use for: "Decision maker?", "Budget approved?", "Current customer?"

URL

• Web address
• Validated format
• Use for: LinkedIn profile, competitor site, case study

Email

• Email address
• Validated format
• Use for: Additional contacts, decision maker email

Phone

• Phone number
• Formatted automatically
• Use for: Mobile, direct line, assistant

Configuring Field Options

Dropdown Options

For dropdown fields, define the options:

1. Create field, set type to Dropdown
2. Click Add Option
3. Enter option label (e.g., "Small (1-10 employees)")
4. Add more options
5. Drag to reorder
6. Set default selection (optional)
7. Save field

Example - Company Size:

Options:
Micro (1-10)
Small (11-50)
Medium (51-200)
Large (201-1000)
Enterprise (1000+)

Required Fields

Make fields required:

1. Edit custom field
2. Toggle Required ON
3. Save

When required:

• Can't save lead without filling it in
• Shows red asterisk on form
• Validation error if left blank

Best practice: Only require fields truly essential for qualification.

Field Visibility

Control where fields appear:

Show on Lead Form:

• ☑ ON: Appears when creating/editing leads
• ☐ OFF: Hidden, only visible in custom section

Show on Lead List:

• ☑ ON: Appears as column in leads table
• ☐ OFF: Only on detail page

Show in Filters:

• ☑ ON: Available in advanced filters
• ☐ OFF: Not filterable

Default Values

Pre-fill fields with common values:

1. Edit custom field
2. Set Default Value
3. Save

Example:

• Field: "Country"
• Default: "United States"
• Saves time for US-based businesses

Using Custom Fields

Filling Out Custom Fields

When creating a lead:

1. Click + New Lead
2. Fill standard fields
3. Scroll to Custom Fields section
4. Fill in custom fields
5. Save

For existing lead:

1. Open lead detail page
2. Find Custom Fields section
3. Click Edit
4. Update fields
5. Save changes

Viewing Custom Field Data

On lead detail page:

• Custom fields shown in dedicated section
• Organized by field type
• Empty fields display "Not set"

In lead list:

• Add custom field columns
• Click Columns → Select custom fields
• View custom data at a glance

Filtering by Custom Fields

Find leads using custom field criteria:

1. Navigate to Leads
2. Click Advanced Filters
3. Select custom field
4. Set condition:

1. Enter value
2. Apply filter

Example filters:

• Budget > $10,000
• Company Size = "Enterprise"
• Product Interest contains "Analytics"
• Decision Date < 30 days from now

Bulk Editing Custom Fields

Update custom fields for multiple leads:

1. Navigate to Leads
2. Select leads (checkboxes)
3. Click Bulk Actions → Edit Fields
4. Choose custom field to update
5. Enter new value
6. Click Update All

Custom Field Best Practices

Plan Before Creating

Ask yourself:

1. What do we need to know to qualify leads?
2. What data helps prioritize follow-up?
3. What info improves our pitch?
4. What metrics matter for reporting?

Don't create fields you won't use.

Keep It Simple

Start with 3-5 custom fields:

• Budget/Deal Size
• Timeline/Decision Date
• Primary Pain Point
• Buying Authority
• Competitor They're Using

Add more only when needed.

Use Dropdowns When Possible

Why dropdowns are better:

• ✓ Consistent data (no typos)
• ✓ Easy to filter and report
• ✓ Faster to fill out
• ✓ Clear options

Free text when:

• Truly unique information
• Can't predict options
• Needs explanation

Name Fields Clearly

Good names:

• "Annual Contract Value"
• "Number of Users"
• "Primary Use Case"
• "Current Solution"

Poor names:

• "ACV" (what does it mean?)
• "Info" (too vague)
• "Field1" (meaningless)

Group Related Fields

Use naming conventions to group:

Example - Product Interest:

• "Product Interest: Analytics"
• "Product Interest: CRM"
• "Product Interest: Marketing"

Shows grouped together in forms and filters.

Review and Clean Up

Quarterly review:

• Which fields are actually used?
• Any fields always empty?
• Fields with outdated options?
• Delete unused fields

Common Custom Field Configurations

B2B SaaS

• Budget (Currency) - Deal size
• Current CRM (Dropdown) - What they use now
• Number of Users (Number) - Seats needed
• Decision Timeline (Date) - When buying
• Decision Maker? (Checkbox) - Authority
• Pain Point (Dropdown) - Primary need
• Competitors Evaluating (Multi-select) - Competition

Consulting/Agency

• Project Budget (Currency) - What they can spend
• Project Timeline (Date) - When needed
• Services Needed (Multi-select) - What they want
• Previous Agency (Text) - Who they used before
• Referral Source (Text) - Who referred them
• Decision Committee (Text) - Who's involved

E-Commerce

• Annual Spend (Currency) - Lifetime value
• Products Purchased (Multi-select) - What they bought
• Preferred Category (Dropdown) - What they like
• VIP Customer (Checkbox) - High value
• Loyalty Points (Number) - Reward balance

Real Estate

• Budget Range (Dropdown) - Price range
• Property Type (Dropdown) - House, condo, etc.
• Desired Location (Text) - Where they want
• Bedrooms (Number) - Size needed
• Move-In Date (Date) - Timeframe
• Pre-Approved? (Checkbox) - Financing ready

Advanced Features

Conditional Fields

Show/hide fields based on other fields:

Example:

• If "Budget" > $50,000
• Then show "Enterprise Features Needed"

Setup:

1. Edit custom field
2. Show When: Select condition
3. Save

Field Dependencies

Require fields based on selections:

Example:

• If "Product Interest" = "Enterprise"
• Then require "Number of Users"

Calculated Fields

Auto-calculate based on other fields:

Example:

• Field: "Monthly Payment"
• Formula: Annual Contract Value ÷ 12

Contact support to set up calculated fields.

Custom Field API

Access custom fields programmatically:

GET /api/leads/{id}/custom-fields
POST /api/leads/{id}/custom-fields

See API documentation for details.

Importing/Exporting Custom Fields

CSV Import with Custom Fields

Custom fields are fully supported in CSV imports:

1. Navigate to Leads → Import
2. Upload your CSV file
3. Click Preview & Map Columns to see your data
4. In the column mapping dropdowns, you'll see:

1. Map your CSV columns to the appropriate fields
2. Set a Default Lead Type below the mapping (Lead, Company, Referral, etc.)
3. Select Tags to Apply to all imported leads (optional)
4. Click Import

Auto-Detection: The import tool automatically detects column names that match your custom field names or labels.

CSV format example:

csv
First Name,Last Name,Email,Company,Company Type,Budget
John,Smith,[email protected],Acme Corp,Construction,25000
Jane,Doe,[email protected],Widget Inc,Restoration,50000

Import Options:

• Default Lead Type: Applied to all imported leads unless a Lead Type column is mapped
• Apply Tags: Select multiple tags to apply to all imported leads (hold Ctrl/Cmd)

For Company-Type Leads: If importing company leads (B2B), set the default lead type to "Company" - the company name will be displayed as the primary identifier.

Export with Custom Fields

Include custom fields in exports:

1. Navigate to Leads → Export
2. Check Include Custom Fields
3. Select which custom fields
4. Download CSV

Troubleshooting

Custom Field Not Saving

Problem: Enter value but doesn't save

Solutions:

• Check field validation (number format, date format, etc.)
• Verify required fields are filled
• Check field type matches data entered
• Clear browser cache and retry

Can't Delete Custom Field

Problem: Delete button grayed out

Cause: Field is referenced in automations or integrations

Solutions:

• Remove field from automations first
• Contact support to force delete

Data Appears Wrong

Problem: Custom field shows unexpected value

Cause: Field type changed or bulk edit error

Fix:

1. Check field type is correct
2. Manually correct the data
3. Or bulk update affected leads

Dropdown Options Missing

Problem: Need to add option to dropdown

Solution:

1. Settings → Custom Fields
2. Edit dropdown field
3. Add new option
4. Save

Note: Can't delete options in use by leads.

Getting Help

Email: [email protected]

Include:

• What custom fields you're trying to create
• Field type and configuration
• Any error messages
• Screenshot if helpful

Last Updated: December 2025