Skip to main content

How to Use Custom Placeholders

This article explains how to use custom placeholders with a CSV import.

Written by Chall

What Are Custom Placeholders

Custom Placeholders pull data from Custom Fields stored on a prospect profile.
They allow you to personalize messages using information imported from a CSV file.

Examples include:

  • {{preferred_contact_time}}

  • {{product_interest}}

  • {{region}}

Each placeholder maps directly to a Custom Field.


When to Use Custom Placeholders

Use Custom Placeholders when:

  • Your prospect data includes fields not available by default.

  • You want to personalize messages beyond name, company, or title.

  • You are importing prospect data from a CSV file.


Preparing Your CSV File

Before importing, prepare your CSV file correctly. Your CSV should:

  • Include a header row.

  • Use clear column names.

  • Contain one data point per column.

Example columns:

  • Preferred Contact Time

  • Product Interest

  • Region

πŸ’‘ Tip: Use simple, descriptive column names. This makes field matching during import easier.


Importing a CSV and Matching Custom Fields

Importing a CSV

  1. Go to Campaigns.

  2. Select "Create New Campaign" in the top-right corner.

  3. Choose a campaign type.

  4. Select "+ Add Search".

  5. Select "CSV File" from the left-hand sidebar.

  6. Select "Add CSV File" and upload your CSV.

Matching CSV Columns to Custom Fields

  1. When prompted to match fields, review each CSV column.

  2. For columns that are not standard fields:

    • Select "Custom Fields" from the field type dropdown.

    • Match the CSV column to an existing Custom Field, or create a new one.

  3. Confirm all columns are mapped correctly.

  4. Select "Save" to complete the import.

🚨 Note: If a column is not matched, its data will not be imported.


​


Using Custom Placeholders in Messages

Once the import is complete:

  • Custom Fields are added to each prospect profile.

  • Corresponding Custom Placeholders become available in campaigns.

To use a Custom Placeholder:

  1. Open your campaign message editor.

  2. Insert the placeholder linked to the Custom Field.

  3. Save your changes.

The placeholder will populate automatically for each prospect.


Best Practices

  • Keep Custom Field names consistent across imports.

  • Avoid creating duplicate fields with similar names.

  • Test your placeholders with a small CSV first.

  • Review prospect profiles after import to confirm data accuracy.


FAQs

Q: Do I need to create Custom Fields before importing a CSV?
A: No. You can create Custom Fields during the column matching step.

Q: What happens if a Custom Field is empty for a prospect?
A: The placeholder will return blank for that prospect.

Q: Can I reuse Custom Placeholders across campaigns?
A: Yes. Custom Placeholders remain available as long as the Custom Field exists.

πŸš€ Success! You can now use Custom Placeholders in Interceptly by importing a CSV and matching columns to Custom Fields.

Did this answer your question?