Summarize this documentation using AI
Overview
Searching and filtering people in Customer.io is the fastest way to answer the questions that actually move revenue for a D2C brand, like “Did this shopper get tagged as abandoned checkout?” or “Why did VIP customers stop receiving replenishment emails?” You use it to spot-check profiles, validate event tracking, and confirm segment logic before you scale sends that impact first purchase conversion and repeat purchase.
If you want this to run cleanly across email, SMS, and paid retargeting audiences without constant manual checks, Propel can help you tighten your data and audience plumbing inside Customer.io (and if you want to pressure test your setup, book a strategy call).
How It Works
Searching and filtering people in Customer.io works by letting you locate individual profiles and then narrow the list using known identifiers and profile data, so you can confirm who should qualify for a message, and who should not.
In practice, teams use this view for three jobs: (1) find a specific shopper by email, phone, or ID, (2) inspect attributes and recent activity to confirm tracking, and (3) apply filters to isolate a group that shares a behavior or state (like “has checkout_started but no order_placed”). When you pair this with segments and campaign entry rules, you get a tight loop for QA and faster iteration in Customer.io.
Step-by-Step Setup
Searching and filtering people in Customer.io is straightforward, but the setup work is really about making sure your identifiers and attributes are consistent enough to be searchable and actionable.
- Decide your primary identifier (email is common, but many D2C brands also standardize phone for SMS). Keep it consistent across Shopify, ESP, and any middleware.
- Standardize key person attributes you will routinely filter on (examples: first_order_date, orders_count, last_order_date, sms_consent, country, marketing_opt_in).
- Standardize key events you will routinely validate (examples: product_viewed, add_to_cart, checkout_started, order_placed, order_refunded).
- From the People area, search for a known customer (use a real test order or your own order) and open the profile.
- Verify the profile has the expected attributes (like lifetime value, order count, and consent flags) and that timestamps look correct.
- Review recent activity to confirm event order (for cart recovery you should typically see product_viewed, add_to_cart, checkout_started, then either order_placed or nothing).
- Use filters to find a small cohort that matches a scenario you care about (for example, “checkout_started in last 4 hours” and “no order_placed”).
- Cross-check that the same cohort matches your segment and campaign entry criteria, then fix inconsistencies in naming, timestamp formats, or identifiers before you widen sends.
When Should You Use This Feature
Searching and filtering people in Customer.io is most valuable when you are trying to protect revenue by catching audience and data issues before they hit scale.
- Abandoned cart and checkout recovery QA: Confirm that shoppers who started checkout are actually being captured, and that purchasers are excluded quickly enough to prevent “You forgot something” messages after purchase.
- First purchase conversion journeys: Validate that new subscribers are correctly labeled as “no orders yet” and that the moment they buy, they move out of prospect messaging.
- Repeat purchase and replenishment: Spot-check that last_order_date updates, and that replenishment windows are calculated off the right timestamp (order placed vs fulfilled).
- Reactivation: Quickly find “lapsed” customers by filtering on last purchase date and engagement signals, then verify they have deliverable contact info and consent.
- Support and CX escalations: When a customer says they never got an order confirmation or got the wrong promo, searching their profile reveals whether the event fired and which messages were queued.
Operational Considerations
Searching and filtering people in Customer.io becomes an operational lever when you use it as part of your QA and audience governance, not just a one-off lookup tool.
- Segmentation hygiene: If your filters rely on attributes like orders_count or lifetime_value, make sure those fields are updated by a reliable source (Shopify integration, CDP, or server-side events), not by fragile client-side scripts.
- Event timing and race conditions: Cart recovery breaks when order_placed arrives late. Build a habit of checking timestamps on real profiles, especially during peak promos.
- Identity resolution: D2C stacks often create duplicates (email capture popups, SMS capture, guest checkout). If profiles are split, your filters will “look wrong” even when tracking is fine.
- Consent and channel readiness: Filtering is only as useful as your consent fields. Keep SMS consent, email opt-in, and suppression status easy to audit on a profile.
Implementation Checklist
Searching and filtering people in Customer.io is easiest to operationalize when you turn it into a repeatable pre-launch checklist for every new journey.
- Primary identifier is consistent across sources (email and or phone).
- Core commerce events exist and are named consistently (product_viewed, add_to_cart, checkout_started, order_placed).
- Order attributes are present and accurate (orders_count, last_order_date, lifetime_value).
- Consent fields are present and usable for channel routing (email_opt_in, sms_consent).
- At least 5 real customer profiles match the intended audience when filtered.
- At least 5 real purchaser profiles are correctly excluded when filtered.
- Timestamps are in the correct format and time zone behavior is understood.
- Duplicate profile risk is understood (guest checkout, multiple devices, SMS vs email capture).
Expert Implementation Tips
Searching and filtering people in Customer.io becomes a revenue tool when you use it to shorten the feedback loop between tracking, segmentation, and message performance.
- Use a “known cohort” for QA: In retention programs we’ve implemented for D2C brands, we keep a small internal list of test profiles that cover edge cases (guest checkout, discount used, subscription, international shipping). Filter to these profiles before every major send.
- Validate exclusion logic first: In retention programs we’ve implemented for D2C brands, most costly mistakes come from not excluding buyers fast enough. When you filter for “entered checkout recovery” and then open 10 profiles, you should see clear evidence they did not purchase in the exclusion window.
- Make attributes filter-friendly: Prefer simple booleans and normalized enums for things you filter constantly (like is_vip, has_subscription, preferred_category) instead of free-text fields that drift over time.
Common Mistakes to Avoid
Searching and filtering people in Customer.io can mislead you if the underlying data model is messy, so avoid these execution traps.
- Using inconsistent event names across tools: If Shopify sends checkout_started but your site sends checkoutStart, filters and segments will miss shoppers and recovery revenue will drop.
- Relying on client-side events for purchase suppression: Ad blockers and checkout redirects can delay or drop purchase events, which causes post-purchase customers to keep matching cart filters.
- Not accounting for duplicates: A shopper who subscribed via SMS and purchased via email can appear as two people. Your filter results will look “too small” and your messaging will feel inconsistent.
- Filtering on fields that are not maintained: Attributes like lifetime_value are powerful, but only if they update reliably. Stale values lead to incorrect VIP targeting and wasted offers.
Summary
Use searching and filtering when you need to verify tracking, debug audience issues, and QA high-impact flows like cart recovery and reactivation.
It is one of the quickest ways to protect revenue and message relevance inside Customer.io.
Implement with Propel
Propel helps D2C teams operationalize Customer.io by tightening identity, event hygiene, and the QA process that keeps journeys profitable. If you want a clean plan for your audience filters and segment governance, book a strategy call.