Custom Fields
Store additional information about contacts beyond standard fields. Custom fields allow you to track industry-specific data, qualification criteria, or any other information relevant to your outreach.
What Are Custom Fields?
Custom fields are user-defined fields that extend the standard contact schema. They're stored as JSON in the database, making them flexible and unlimited.
Standard Fields (Built-in)
email- Email address (required, unique)first_name- First name (required)last_name- Last name (required)company- Company name
Custom Fields (User-Defined)
Anything else! Examples:
job_title- VP Sales, Marketing Director, etc.industry- SaaS, E-commerce, Healthcare, etc.company_size- 1-10, 11-50, 51-200, etc.lead_score- Hot, Warm, Coldlast_interaction- Webinar, Demo, Trial, etc.pain_point- Specific challenge they're facinglinkedin_url- LinkedIn profile
How to Add Custom Fields
Via CSV Upload
The easiest way to add custom fields is to include them as columns in your CSV:
email,first_name,last_name,company,industry,company_size,lead_score
john@acme.com,John,Smith,Acme Corp,SaaS,51-200,Hot
sarah@beta.com,Sarah,Chen,Beta Inc,E-commerce,11-50,Warm
WarmOpener will automatically create custom fields for any columns not matching standard fields.
Via Manual Entry
When adding/editing a contact:
- Fill in standard fields (email, first name, last name)
- Scroll down to "Custom Fields" section
- Click "Add Custom Field"
- Enter field name (e.g., "industry")
- Enter field value (e.g., "SaaS")
- Click "Save"
Using Custom Fields
In Email Templates
Use custom fields as placeholders in email templates:
Hi {{first_name}},
I noticed {{company}} is in the {{industry}} space. I've helped similar {{company_size}} companies increase outreach efficiency by 40%.
Given your recent {{pain_point}}...
In AI Personalization
Custom fields provide AI with more context for better personalization:
AI Prompt Example: "Based on this contact's industry ({{industry}}) and company size ({{company_size}}), write a relevant pain point they might be experiencing."
In Contact Segmentation
Filter contacts by custom fields to create targeted lists:
- All contacts in "SaaS" industry
- Companies with "51-200" employees
- "Hot" leads only
- Contacts who attended "Webinar"
Best Practices
Naming Conventions
- Use lowercase with underscores:
company_sizenot "Company Size" - Be descriptive:
last_webinar_attendednot "webinar" - Keep consistent across all contacts
Data Quality
- Use consistent values: "SaaS" not "saas", "Software", "SAAS"
- Standardize formats: "51-200" not "50 to 200" or "medium"
- Fill all fields when possible (more data = better AI)
Performance
- No limit on number of custom fields
- Stored as JSON - no schema migrations needed
- Can be indexed for fast filtering (if needed)
💡 Pro Tip
The more custom fields you have, the better your AI personalization will be. Aim for at least 5-7 custom fields per contact (industry, company size, recent news, pain point, etc.). Contacts with rich data get 3-4x higher reply rates than those with just name and email.