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:

  1. Create multiple sequences:

    • Language learned → English

    • Language learned → German

    • Language learned → Spanish

  2. Prepare separate CSV files for each sequence based on your custom variable values

  3. 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