Create Ads from CSV

This guide walks you through how to create ads in bulk by uploading a CSV file to the UI. While you can create ads individually in the Kevel UI or programmatically via the API, uploading a CSV file allows you to quickly upload several similar ads, for example, a global campaign localized to 18 languages.

Step 1: Prepare your file

Use a template file below (or edit an existing file) and fill all columns with the specific information corresponding to Creative and Ad settings fields. You can include additional columns, but these will be ignored. However, additional columns can be useful if you have an existing spreadsheet or derive Kevel-required values from a combination of columns using a formula or concatenation. Files can contain up to 100 rows.


Template Files

Supported Columns

The below list outlines supported columns for Creative and Ad details. To learn more about acceptable values for each column, see the Creative and Ad API documentation pages.

Column Name

Ad Size ID*



Click URL

Alt Text

Script Body


External Image Link


Custom Targeting

Site ID

Zone ID

*indicates required column

Step 2: Upload CSV to a Flight


With your CSV in hand:

  1. Create/edit a Flight.
  2. Navigate to the Creatives panel and select the "Create Ads from CSV" button.
  3. You will be prompted to upload your CSV file. Kevel then scans the CSV for the required headers.
  4. After Kevel validates your file, you will be prompted to confirm creation of ads.
  5. Once the process completes, the Kevel UI provides feedback on how many ads were successfully created, and which rows in the CSV had errors (if any).

Now your ads are ready to be served!