Can I import custom variables when uploading CSV files?
Last updated: October 21, 2026
Context
When importing CSV files into lists, you may want to include custom variables that are specific to your CRM system, such as language learned by contacts or other custom fields that help segment your data.
Answer
Currently, importing custom variables directly through CSV uploads is not supported.
For Company Data (inclusion and exclusion)
When importing company CSV files, you only need these minimum required columns:
company_name(required)company_url(required)company_linkedin_url(optional but recommended)
For Contact Lists (inclusion and exclusion)
When importing contact CSV files, you must include at least one of the following identifiers per contact:
LinkedIn profile URL (recommended)
Professional email (recommended)
Full name + company name/domain
Understanding the Column Mapping Interface
During CSV import, the column mapping interface displays Topo's available fields on the left side and the columns found in your uploaded CSV file on the right side. Topo automatically attempts to match columns from your CSV to its standard fields (Email, First Name, Last Name, Phone, LinkedIn URL, Job Title, Company, etc.). If a field like 'Phone' appears unmapped, it means that specific column doesn't exist in your CSV file—not that the field is unavailable in Topo.
However, there is an effective workaround to achieve similar segmentation results.
Recommended Workaround
Create separate lists for each custom variable value. For example, if you want to track "language learned" by contacts:
Create multiple sequences:
Language learned → English
Language learned → German
Language learned → Spanish
Prepare separate CSV files for each sequence based on your custom variable values
Import each CSV into its corresponding sequence
Benefits of this approach:
Easier comparison of results based on your custom variables
Better performance tracking across different segments
Clear separation of data for analysis purposes