export const exportDashboard = '/docs/images/export-guides/klaviyo/export-dashboard.webp'
export const exportList = '/docs/images/export-guides/klaviyo/export-segment-csv.webp'
export const exportSegments = '/docs/images/export-guides/klaviyo/export-create-segment.webp'

export const exportView = '/docs/images/export-guides/klaviyo/export-view-exports.webp'
export const exportDownloads = '/docs/images/export-guides/klaviyo/export-download.webp'

export const exampleFile = 'migration-guides.js'


# Export Data from Klaviyo for Bento

This guide will help you export all the contacts, tags, segments, and custom fields you need from Klaviyo so you can import them into Bento.  


Exporting your data is safe and does not affect your live Klaviyo account. You can continue sending emails while you prepare your migration.


<div className="grid grid-cols-1 sm:grid-cols-2 gap-6 mb-8">
  <div className="space-y-2">
    ## Prerequisites
    <div className="flex items-start">
      
      <span>Access to your Klaviyo account</span>
    </div>
    <div className="flex items-start">
      
      <span>Required permissions to export data</span>
    </div>
    <div className="flex items-start">
      
      <span>A place to save your exported CSV files</span>
    </div>
    <div className="flex items-start">
      
      <span>Spreadsheet software to review and clean up CSVs</span>
    </div>
  </div>
  <div>
    ## What You'll Export
    - **Members (Contacts)**
    - **Segments & Lists**
    - **Custom Fields**
    - **Automations (Flows, for mapping later)**
  </div>
</div>

---

## Step-by-Step Export Process


  
  
    
      
        Go to <a href="https://www.klaviyo.com/login" target="_blank" rel="noopener noreferrer">Klaviyo</a> and log in with your credentials. Navigate to the `1` **`Audience`** section and select `2` **`Lists & Segments`**.
      
      
        <div className="bg-zinc-800 border border-zinc-700 rounded-lg px-2 pb-1 text-center">
          
        </div>
      
    
  

  
  
    
      
        The simplest way to create the required `CSVs` for import into Bento is to create a segment containing all your subscribers, and another that contains all your unsubscribed contacts. To begin, click `3` **`Create New`** button and select `Create Segment`.

      In the segment builder, enter subscriber as the name, select the tags that contain your subscribers. Make sure you filter on `if someone can or cannot receive marketing` and person `can receive` | `email marketing`.  Then click `Create Segment` button in the upper right corner.

        
          If you have many tags, and wish to keep them separated, repeat this process for each tag, and we recommend naming the segment with the tag name.
        

        When importing to Bento you will need to import all unsubscribed contacts, so we need to create a second segment for them. Let's repeat the process, but this time we will name the segment Unsubscribed. In the segment builder, enter unsubscribed as the name, select the same tags that you selected for subscribers. Make sure you filter on `if someone can or cannot receive marketing` and person **`cannot receive`** | `email marketing`.  Then click `Create Segment` button in the upper right corner.

        
> 🚨 **Important**
> Failing to import an unsubscribed list into Bento may result in emailing contacts who have unsubscribed from your list, which hurts your sending reputation.


      
      
        <div className="bg-zinc-800 border border-zinc-700 rounded-lg px-2 pb-1 text-center mb-3">
          
        </div>

        <div className="bg-zinc-800 border border-zinc-700 rounded-lg px-2 pb-1 text-center mb-3">
          
        </div>

        <div className="bg-zinc-800 border border-zinc-700 rounded-lg px-2 pb-1 text-center mb-3">
          
        </div>
      
    
  

  
  
    
      
        From any of your segments click the `Manage Segment` button and select `View my exports`.<br/>
        This list out all the exports you have created for all segments. Click on the download button to download them.
        
> Make sure you name each export when you download it according to the segment name. Such as `subscribers.csv` & `unsubscribes.csv`

      
      
        <div className="bg-zinc-800 border border-zinc-700 rounded-lg px-2 pb-1 text-center mb-3">
          
        </div>

        <div className="bg-zinc-800 border border-zinc-700 rounded-lg px-2 pb-1 text-center mb-3">
          
        </div>
      
    
  

  
  
    
      
        Custom fields are included in your segment export CSV. Review the CSV columns to see all custom fields in use.
      
      
    
  

  
  
    
      
        For automations (Flows), there is no direct export. Take screenshots or document the steps for reference when rebuilding in Bento Flows.
      
      
    
  


---

## Merge & Clean

1. **Open each of the exported CSV** in your spreadsheet tool.
2. **Rename columns** to Bento‑friendly names (`email`, `first_name`, `tags`, etc.), ensure they match in each csv file.
3. Comma‑separate multiple tags (e.g. <code>vip,customer</code>).
4. Delete any blank or irrelevant columns — Bento ignores missing headers but a tidy sheet is easier to debug.
5. Save each CSV as a separate file.

### Column Map Example

| Email              | Tags          | Remove Tags | First Name | Last Name |
|--------------------|---------------|-------------|------------|-----------|
| jesse@bentonow.com | customer, mql | lead        | Jesse      | Hanley    |


---
## After Exporting

- Double-check your CSV files for all required data (contacts, tags, segments, custom fields).
- Organize your files and screenshots for easy access during the Bento import process.
- If you need to clean up or rename tags/fields, do so in the CSV before importing to Bento.

---

## Troubleshooting


  
    <b>Missing Data?</b><br/>
    - Make sure you exported from the correct section (Lists, Segments, Profiles).
    - Check your downloads folder for the CSV file.
    - Open CSVs in a spreadsheet app to review all columns.
    - Lists over 100k contacts? Klaviyo may split exports into multiple CSVs—download every part and combine before merging statuses.
  
  
    <b>Export Button Not Visible?</b><br/>
    - You may need Owner, Admin, or Analyst permissions to export data.
    - Try a different browser or clear your cache.
    - Contact Klaviyo support if you still can't export.
  


---

## Critical Terminology: Klaviyo → Bento

Before we dive in, let’s align on key concepts. This table is your Rosetta Stone for migrating mental models from **Klaviyo** to **Bento**.

| Klaviyo Term       | Bento Term           | What It Actually Means                                                                  |
|--------------------|----------------------|-----------------------------------------------------------------------------------------|
| `Profile`          | `Person`             | A human with an email address                                                           |
| `Tag` (Property)   | `Tag`                | Labels for categorization — in Bento, tags are first-class and support advanced logic   |
| `Segment`          | `Segment`            | Dynamic groupings based on field values, tag presence, events, and more                 |
| `Custom Property`  | `Field`              | Custom data attached to a `Person`, like `first_name`, `plan`, or `last_seen_at`        |
| `Campaign`         | `Broadcast`          | A one-time email sent to a specific group or segment                                    |
| `Flow`             | `Flow`               | If-this-then-that workflows — Bento Flows support triggers, delays, branching, and more |
| `Event`            | `Event`              | Track pageviews, clicks, custom behavior — all events are first-class in Bento          |
| `Liquid`           | `Liquid`             | Dynamic content via [Liquid](https://docs.bentonow.com/liquid_guide) templating         |

 Bento tracks all clicks and visits automatically — no manual link triggers or extra setup needed.

### The Mental Model Shift
`Klaviyo:` "Here's a list of Profiles with Segments and Flows."

`Bento:` "Here's a person who visited 5 pages, clicked 3 emails, has an LTV of $497, and is currently browsing your pricing page."

## Final Thoughts
This migration will take you 2–4 hours of actual work.

**Remember:**
* Take screenshots before changing anything
* Test with your **own email** first
* Keep Klaviyo running during transition
* Document everything for your future self


> If something just doesn't go right, you can always re-import from Klaviyo and try again. <br />That's why we keep it running until we're sure.


## Quick Reference
**During Migration:**
* Check Bento's Dashboard
* Monitor deliverability score
* Test forms and integrations
* Send one test email after changes

**Before Canceling Klaviyo:**
* All Profiles are imported
* All automations rebuilt
* List is warmed up on Bento
* Forms all working
* Deliverability metrics stable

**Emergency Contacts:**
* Bento Support: [Discord](https://discord.gg/ssXXFRmt5F) | [support@bentonow.com](mailto:support@bentonow.com)
* Status Page: [status.bentonow.com](https://status.bentonow.com)
* API Docs: [docs.bentonow.com](https://docs.bentonow.com)

You've got this. And if you don't? That's what support is for.
*Ship it.*