Skip to content
  • There are no suggestions because the search field is empty.

What Is the Field Mapper, and How Do I Use It When I Create a Campaign from a CSV?

This article explains the Field Mappings screen in Create Campaign: how to upload a CSV, choose which columns to import, and confirm where each one lands. It covers two common file types, category-tag files that control Dynamic Video clip selection and exports from a CRM or email platform such as Salesforce or Mailchimp, and which columns to include for each.

The Field Mapper is the Field Mappings screen you see after uploading a CSV to create a campaign. It lists every column in your file and lets you choose which ones to import and which Spokenote metafield each one feeds. Spokenote creates one page per row. What you include depends on your file. A category-tag CSV built to drive Dynamic Video needs the category columns that decide which clip each person gets. A CRM or email-platform export needs the columns that identify each recipient, like record ID, name, and email.

“I uploaded a CSV to build a campaign. What is the Field Mapper, and which columns should I include?”

A metafield is a Spokenote field that holds one piece of information about each recipient, such as an email address or a category like industry.

What kind of CSV do you have?

Category-tag CSV CRM or email-platform export
What it is A file built to tell Dynamic Video which clips to use A contact list exported from a system like Salesforce or Mailchimp
Columns that matter Category tags such as member_type, industry, interest_segment Recipient details such as record_id, first_name, last_name, email
What Spokenote does with them Uses each recipient’s category values to pick their clips Stores who each page belongs to

Some files have both. The sample file in our test had recipient details and category tags in the same CSV. If yours does, use both sets of guidance below.

Part 1: Create the campaign and upload your CSV

  1. Open Create Campaign.
  2. Under How would you like to create the campaign?, choose Upload a CSV.
  3. Under How will the content on these pages be managed?, choose Collectively or Individually. Collectively means content is managed in one place and applied to every page. Most Dynamic Video campaigns use Collectively, and once a Collectively campaign is saved it can’t be changed, so choose with that in mind.
  4. Optional: leave the box checked to assign yourself as the page owner for each page.
  5. Enter a Campaign name (required) and choose your CSV file. The maximum is 20,000 rows.
  6. Check the yellow banner. It shows how many pages the campaign will create and how many credits that uses. Each row creates one page, and each page uses 1 credit.
  7. Click Upload CSV and Map Fields.

Part 2: Work through the Field Mappings screen

The screen header shows how many columns Spokenote found in your file, for example Field Mappings (9 fields). Above the table, three counters track your choices: Fields to Import, Existing Metafields, and New Metafields.

  1. Choose what to import. Nothing is imported until you check its box in the Include column. Use Include All or Exclude All (top right) to start from one extreme, or the search box to find a column.
  2. Check each match. For every included column, look at Mapping Type and Target Metafield (Spokenote). In our test, each column matched the existing Spokenote metafield with the same name. Confirm each target is the one you intend.
  3. Check the counters. Fields to Import should equal the number of columns you ticked.
  4. Click Create Campaign from CSV. It stays unavailable until you include at least one column.
  5. When you see Campaign created successfully!, you land on your campaign with Overview, Analytics, and Editor tabs.

Part 3: Which columns to include

Track A: Category-tag CSV (controls Dynamic Video)

  • Include every category column you want to use to choose clips, such as member_type, industry, engagement_intent, or interest_segment.
  • Why: Spokenote matches each recipient’s value in these columns to a clip in the Dynamic Video Editor. A column you leave out can’t choose a clip.
  • Watch out: keep values identical for the same category. Different spellings or stray spaces can make one category look like two. Check your file for hidden formatting or special characters before uploading. Every value needs a clip, so a category with six values means six clips.

Track B: CRM or email-platform export (Salesforce, Mailchimp, and similar)

  • Include the columns you need to recognize each recipient when you export your personalized links, such as record_id, first_name, last_name, and email.
  • Why: these columns tell your pages apart, so you can match each personalized link back to the right person in your email platform.
  • Watch out: leave out columns you don’t need. If your export uses different header names than Spokenote’s metafields, use the Target Metafield dropdown to point each column to the right one.

What happens next

In the Editor tab, the Dynamic Video Editor uses your category columns to choose clips. Each column is tied to one field, and each clip in a column represents one value of that field. A Manual Clip column plays the same clip for everyone. For the editor walkthrough, see [RELATED ARTICLE: How to use the Campaign Editor].

Quick Reference

On screen What it does
Include checkbox Imports that column. Unchecked columns aren’t imported
CSV Column Your column header and its data type
Mapping Type Shows whether the column maps to an existing metafield
Target Metafield (Spokenote) The Spokenote field the column feeds
Fields to Import How many columns you’ve ticked
Create Campaign from CSV Builds the campaign, one page per row

What to Check Next

  • Is Create Campaign from CSV greyed out? Include at least one column.
  • Did you pick Collectively? Check your clips and links before saving, since Collectively campaigns lock after saving.
  • Ready to send? Export your personalized links as a CSV and merge them into your email platform. See [RELATED ARTICLE: How do I send my Dynamic Video links to my recipients?]

When to Contact Support

  • Your CSV is over 20,000 rows.
  • A column won’t map to the metafield you expect.
  • Your page count or credit total doesn’t match your file.