Export Objects or Relationships via CSV in Customer.io

Customer.io partner logo

Table of Contents

Summarize this documentation using AI

This banner was added using fs-inject

Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Overview

Exporting objects or relationships via CSV is the fastest way to pull clean, product-level data out of Customer.io when you need to audit segmentation, troubleshoot personalization, or hand off a data file to merchandising and CX. In a D2C retention program, this matters most when your messaging depends on non-person data like products, SKUs, subscriptions, bundles, or a customer-to-product relationship (for example, what someone bought, what they last browsed, or what they is eligible to reorder).

If you are trying to turn product and purchase data into repeat purchase systems quickly, Propel can help you structure objects and relationships so exports match how your team actually merchandises and sells. If you want help validating your object model before you scale campaigns, book a strategy call.

How It Works

Export objects or relationships via CSV in Customer.io by selecting an object type (like Product, Order, Subscription, or Back-in-stock Variant) or a relationship (like Person purchased Product), then downloading a CSV snapshot of the records currently stored.

Practically, this export becomes your source of truth for three common jobs: confirming the object fields you can personalize with, checking relationship integrity (are people actually connected to the right product records), and creating an offline review workflow (merch team reviews a list, then you update data upstream).

Most D2C teams use this when something feels off in performance, like a replenishment flow under-sending, an upsell email showing blank product names, or a winback segment suddenly shrinking. With Customer.io, the CSV export is often the quickest way to see whether the issue is data coverage, relationship mapping, or segmentation logic.

Step-by-Step Setup

Export objects or relationships via CSV in Customer.io when you need a portable view of your product and purchase model for QA, analysis, or cross-team collaboration.

  1. Confirm what you need to export: an object type (for example, Product or Order) or a relationship (for example, Person has_active_subscription Subscription).
  2. Open your Objects area and choose the relevant object type or relationship you want to review.
  3. Use any available filters or views to narrow the export to the records you actually care about (for example, only active subscriptions, only products in a specific collection, only relationships created in the last 30 days).
  4. Run the export and download the CSV.
  5. Spot-check the CSV for the fields you rely on in messaging (SKU, variant title, price, compare_at_price, subscription cadence, last_order_date, next_charge_date).
  6. Validate relationship coverage by checking for missing links (for example, customers with orders but no Order object relationship, or products referenced in events but not present as Product objects).
  7. Share the CSV with your team and document the changes required upstream (Shopify catalog cleanup, subscription platform field mapping, event naming fixes, or ETL adjustments).

When Should You Use This Feature

Export objects or relationships via CSV in Customer.io when revenue depends on product-aware targeting and you need to verify the data before you scale spend or volume.

  • Abandoned cart recovery QA: If cart emails are missing item names or images, export Product objects and the cart-to-product relationship to see which SKUs are failing to resolve.
  • Replenishment and reorder flows: For consumables, export Subscription or Order objects to confirm cadence, last purchase date, and eligibility windows before you turn on SMS.
  • Product discovery journeys: If you run browse-based campaigns (viewed collection, viewed product, quiz result), export Product objects to validate tags, categories, and merchandising attributes used in segmentation.
  • Winback and reactivation: Export relationships like Person purchased Product to build a quick analysis of what categories churn fastest, then tailor reactivation offers by category.
  • VIP and LTV segmentation: Export Order objects to reconcile AOV, order count, and last order date when finance and marketing numbers do not match.

Operational Considerations

Export objects or relationships via CSV in Customer.io works best when you treat it as an operational QA tool, not a one-off data pull.

  • Decide the source of truth: If Shopify is canonical for product fields, do not “fix” missing titles in Customer.io. Use the export to identify gaps, then repair the feed upstream.
  • Plan for object drift: Product catalogs change constantly (new variants, renamed SKUs, archived products). Schedule periodic exports for high-impact object types so your personalization does not degrade quietly.
  • Align relationship naming with campaign logic: If your flows branch on “purchased_category = skincare,” make sure the relationship or object fields actually support that logic at scale.
  • Orchestration across tools: In multi-tool stacks (ESP plus subscription platform plus reviews), exports help you map which fields are missing in Customer.io versus missing in the upstream platform.

Implementation Checklist

Export objects or relationships via CSV in Customer.io is easiest when you standardize what you check every time.

  • List the exact fields used in Liquid for your top 5 revenue flows (cart, post-purchase cross-sell, replenishment, winback, VIP).
  • Export the object type and confirm those fields are populated for at least 95 percent of relevant records.
  • Export the relationship and confirm people are linked to the right objects (no orphaned orders, no missing product references).
  • Check for duplicated records (same SKU represented multiple times, multiple active subscriptions per customer when it should be one).
  • Document the remediation owner (data team, ecommerce ops, retention) and where the fix should occur (Shopify, ETL, event tracking, subscription platform).
  • Re-test the impacted messages after fixes (preview with a few real profiles, then send internal proofs).

Expert Implementation Tips

Export objects or relationships via CSV in Customer.io becomes a revenue lever when you use it to protect personalization quality in high-volume automations.

  • In retention programs we have implemented for D2C brands, the biggest gains come from exporting and auditing the exact objects powering your top flows before scaling SMS. Email can tolerate minor personalization gaps, SMS cannot.
  • Use exports to build a “field coverage scorecard” for merchandising attributes (category, skin concern, size, flavor, bundle eligibility). If coverage drops after a catalog update, you will see it before conversion falls.
  • When debugging underperforming replenishment, export Order objects and compare last_order_date distribution to your holdout group. Many times the issue is a timestamp format mismatch rather than offer strategy.
  • Keep a small library of “known good” customer IDs and SKUs. Each time you change data mapping, export and confirm those records still look right.

Common Mistakes to Avoid

Export objects or relationships via CSV in Customer.io can save hours, but only if you avoid the traps that create false conclusions.

  • Exporting the wrong layer: Teams export Product objects when the issue is actually the relationship between Cart and Product, or Person and Order.
  • Assuming blanks are segmentation problems: If a message shows empty product titles, it is usually missing object fields, not a broken segment.
  • Fixing data in the wrong place: Patching Customer.io data manually can create drift. Use the export to identify gaps, then fix the upstream system.
  • Not validating new variants: New SKUs often launch without the attributes your flows expect (image, category, margin tier). Exports catch this before you send broken cross-sells.
  • Ignoring time windows: Relationship exports without a timeframe can hide recent pipeline failures. Always check recent records when troubleshooting.

Summary

Export objects or relationships via CSV is the quickest way to QA product-aware targeting and personalization before it impacts conversion.

Use it when you rely on object data for cart recovery, replenishment, cross-sell, or winback flows in Customer.io.

Implement with Propel

If you want your object model to reliably power repeat purchase and reactivation, Propel can help you map the right objects, relationships, and QA process inside Customer.io. book a strategy call.

Contact us

Get in touch

Our friendly team is always here to chat.

Here’s what we’ll dig into:

Where your lifecycle flows are underperforming and the revenue you’re missing

How AI-driven personalisation can move the needle on retention and LTV

Quick wins your team can action this quarter

Whether Propel AI is the right fit for your brand, stage, and stack