Meta tags:
description=Collections provide a way to store data in your workspace that you can use in automations with Liquid.;

Headings (most frequently used words):

collection, the, of, your, retrieve, collections, query, to, reference, created, content, how, use, data, info, with, new, you, ve, already, all, update, customer, io, results, attributes, can, we, make, it, better, what, create, in, messages, api, add, action, build, relevant, liquid, creating, once, has, following, json, definition, about, list, name, and, delete, latest, features, at, choose, decide, store, preview, profile, journey, names, for, familiar, parts, see, which, email, clients, recipients, manage, accounts, single, login,

Text of the page (most frequently used words):
the (93), and (88), #messages (81), app (79), push (77), your (76), data (68), collection (64), you (49), for (49), events (47), customer (46), started (44), set (43), track (39), profiles (39), notifications (38), email (37), with (37), get (36), api (35), use (31), identify (30), metrics (29), how (27), message (27), troubleshooting (27), content (26), collections (26), name (25), this (22), automation (22), tracking (22), create (21), send (21), from (19), links (19), google (18), can (17), what (17), attributes (17), query (17), add (17), that (17), automations (17), mobile (17), changelog (17), event (17), update (16), journey (16), account (16), multiple (16), anonymous (16), getting (16), new (15), objects (15), attribute (15), start (15), json (14), reference (14), deep (14), liquid (13), manage (13), listeners (13), activity (13), test (13), custom (12), quick (12), guide (12), inbox (12), integrations (12), page (11), profile (11), csv (11), using (11), advanced (11), messaging (11), users (11), authentication (11), capture (11), options (11), subscription (11), about (10), retrieve (10), all (10), store (10), inline (10), android (10), channels (10), screen (10), lifecycle (10), segments (10), privacy (9), support (9), our (9), not (9), edit (9), handling (9), providers (9), configuration (9), works (9), migrate (9), transactional (9), editor (9), results (8), file (8), introduction (8), time (8), billing (8), notification (8), webhooks (8), emails (8), service (7), features (7), delete (7), list (7), preview (7), choose (7), url (7), items (7), specific (7), person (7), workspace (7), security (7), flutter (7), packages (7), version (7), design (7), studio (7), integration (7), forms (7), components (7), overview (6), provide (6), created (6), sheet (6), have (6), array (6), available (6), description (6), single (6), access (6), filters (6), updates (6), based (6), each (6), analysis (6), feature (6), settings (6), sms (6), ios (6), react (6), native (6), amazon (6), conditions (6), inbound (6), pipelines (5), info (5), build (5), action (5), example (5), are (5), object (5), assign (5), course_recommendations (5), map (5), item (5), click (5), one (5), addresses (5), best (5), practices (5), whatsapp (5), location (5), earlier (5), rules (5), segment (5), frequently (5), asked (5), questions (5), legacy (5), hubspot (5), actions (5), code (5), out (5), javascript (5), syntax (5), sending (5), triggered (5), broadcasts (5), welcome (5), link (5), css (5), policy (4), journeys (4), platform (4), team (4), will (4), need (4), copy (4), already (4), relevant (4), https (4), can_deliver (4), quantity (4), price (4), don (4), cannot (4), type (4), via (4), promo_course (4), then (4), first (4), them (4), now (4), limit (4), when (4), want (4), filter (4), courses (4), workflow (4), learning (4), people (4), 2026 (4), understand (4), accounts (4), builder (4), groups (4), rich (4), apis (4), conversions (4), snowflake (4), reporting (4), storage (4), bigquery (4), redshift (4), webhook (4), client (4), understanding (4), tests (4), recipes (4), branches (4), timestamp (4), opt (4), statuses (4), preferences (4), global (4), component (4), faq (4), styles (4), layouts (4), domain (4), style (4), relationships (4), docs (4), documentation (3), feedback (3), part (3), help (3), make (3), following (3), definition (3), creating (3), decide (3), given (3), false (3), true (3), aren (3), updated (3), include (3), rows (3), share (3), know (3), row (3), limited (3), value (3), course (3), last (3), see (3), 100 (3), outside (3), information (3), could (3), level (3), select (3), only (3), than (3), column (3), weeks (3), python (3), headers (3), files (3), sends (3), they (3), upcoming (3), promotions (3), enterprise (3), plans (3), premium (3), plan (3), releases (3), login (3), conversion (3), workspaces (3), sign (3), roles (3), standard (3), performance (3), upgrade (3), expo (3), implementation (3), certificates (3), visual (3), website (3), twilio (3), slack (3), salesforce (3), mixpanel (3), facebook (3), ads (3), cohorts (3), triggers (3), server (3), reverse (3), etl (3), beta (3), live (3), common (3), compliance (3), deliverability (3), broadcast (3), goals (3), errors (3), personalize (3), web (3), multi (3), types (3), trigger (3), workflows (3), why (3), center (3), templates (3), surveys (3), phone (3), integrate (3), drag (3), drop (3), smtp (3), export (3), mcp (3), agent (3), clients (3), status (2), contact (2), resources (2), pricing (2), parcel (2), close (2), better (2), helpful (2), download (2), once (2), has (2), steak (2), replace (2), put (2), encoded (2), text (2), returns (2), details (2), but (2), does (2), any (2), schema (2), bytes (2), either (2), extension (2), contains (2), region (2), result (2), instead (2), directly (2), first_course (2), such (2), endfor (2), stored (2), sample (2), tab (2), like (2), change (2), during (2), limits (2), setting (2), under (2), let (2), retrieves (2), give (2), step (2), power (2), more (2), configure (2), must (2), basics (2), might (2), upload (2), drive (2), take (2), lists (2), should (2), through (2), storing (2), classes (2), individual (2), separate (2), index (2), browser (2), issues (2), cookies (2), expiration (2), search (2), two (2), members (2), tasks (2), audit (2), logs (2), verification (2), provisional (2), sound (2), sdks (2), html (2), comparing (2), pixel (2), sendgrid (2), marketing (2), rudderstack (2), azure (2), blob (2), cloud (2), audiences (2), braze (2), amplitude (2), connections (2), past (2), mode (2), servers (2), deleting (2), other (2), services (2), postgresql (2), mysql (2), microsoft (2), sql (2), incoming (2), requests (2), csp (2), proxying (2), management (2), another (2), disconnect (2), backend (2), form (2), lead (2), video (2), semantic (2), directory (2), dashboard (2), personalization (2), zone (2), reusable (2), exit (2), flow (2), names (2), batch (2), concepts (2), reminders (2), trial (2), book (2), customers (2), nps (2), frequencies (2), library (2), find (2), brand (2), adding (2), parameters (2), localization (2), line (2), activities (2), respond (2), adoption (2), display (2), number (2), sender (2), validate (2), senders (2), adapting (2), template (2), own (2), relay (2), collaborate (2), connected (2), review (2), accessibility (2), shortcuts (2), match (2), devices (2), work (2), segmentation (2), import (2), non (2), their (2), survey (2), suggestions (2), setup (2), cli (2), academy (2), structured (2), which (2), demo (2), 2024, peaberry, software, inc, terms, 9450, gemini, suite, 43920, beaverton, oregon, 97008, 7105, win, startup, program, partners, careers, company, guides, competitors, community, blog, release, notes, soon, possible, appreciate, bot, please, valid, address, optional, improve, yes, copied, clipboard, deletes, com, pizza, hot, dog, existing, provided, associated, collection2, collection1, entire, used, remember, enforce, name3, name2, name1, number_of_rows_in_collection, collection_name, 1589471132, updated_at, 1589471110, created_at, bytes_of_data_in_collection, newline, delimited, ensure, parse, assume, providing, both, post, endpoints, panel, would, return, user, kib, 128, per, beyond, fail, moves, forward, without, overall, keep, mind, temporarily, expires, exits, accessible, whether, where, equal, skill_level, condition, recommendations, skill, reaches, stores, parameter, subsequent, added, next, meaning, particular, smaller, represents, header, becomes, machine, dive, into, algorithms, alice, johnson, intermediate, analyze, datasets, john, doe, beginner, learn, programming, jane, smith, duration, instructor, look, sharing, expect, simple, table, grant, advantage, flexible, simply, require, schemas, indexes, however, larger, able, sort, tailored, online, offered, represent, things, exist, business, instance, coupons, way, july, 3_collections, upgrading, talk, complete, llms, txt, har, qualifications, respecting, gdpr, allowlist, session, case, sensitivity, timezone, enable, experimental, regions, sso, factor, credentials, customize, canceling, payment, problems, reducing, overages, credits, bill, sdk, channel, swift, zendesk, yandex, wisepops, optimizer, vwo, twitter, engage, tiktok, talon, sprig, saleswings, sent, ripe, qualtrics, playerzero, pipedrive, pinterest, moengage, metronome, meta, logrocket, livelike, launchdarkly, koala, intercom, heap, tag, manager, gtm, sheets, analytics, gtag, gainsight, fullstory, friendbuy, criteo, cordial, commandbar, clevertap, bing, attio, algolia, insights, adobe, target, actable, predictive, resend, filtering, mapping, database, warehouse, zoho, zapier, mparticle, classic, platforms, node, call, calculator, scheduled, syncs, invalid, transform, utility, methods, identity, managing, identities, method, frameworks, wordpress, wpforms, webflow, unbounce, typeform, squarespace, jotform, formstack, sources, backfill, historical, playback, chat, ecommerce, fields, alias, group, source, specs, failed, attempted, conclusive, reports, home, composer, reusing, snippets, supported, formats, zones, recommended, geolocation, queue, draft, behavior, default, direct, mail, lob, receive, randomized, delay, wait, until, window, delays, blocks, random, split, control, reformat, fix, inconsistent, holdout, llm, generate, decisions, examples, key, format, inactive, trips, rss, feed, cohort, optimize, just, words, onboarding, double, cart, abandonment, birthday, anniversary, recipe, grace, periods, tickets, syncing, sync, stripe, follow, responses, receiving, entering, troubleshoot, state, schedule, criteria, tags, image, requirements, assets, language, preference, faqs, pages, unsubscribes, universal, checking, translations, translate, languages, milestones, achievements, promote, offers, localize, compose, telehealth, weight, hipaa, regulations, kind, campaign, registration, compliant, register, numbers, keyword, smart, character, encoding, keywords, shortening, mms, payloads, registering, device, tokens, provider, trustpilot, reviews, gmail, fake, bcc, option, preheader, avatar, logo, mailchimp, foundation, basic, view, amp, pre, processing, archive, customizing, right, editors, consent, open, oracle, dyn, sparkpost, postmark, mandrill, mailjet, mailgun, verify, deliverable, kickbox, anonymized, authenticating, apple, private, unsubscribe, rfc, 8058, postmaster, tools, suppression, suppressions, spamhaus, blocklist, listings, shared, dedicated, warming, attachments, transitioning, history, submit, teammates, stylesheet, loop, conditionals, directives, modifiable, placeholder, scratch, publish, changes, connect, quality, mso, emmet, fixes, variables, cleanup, formatting, inlining, mjml, framework, transformers, responsive, dark, keyboard, convert, purposes, within, days, building, manual, driven, activate, waitlist, awareness, announce, usage, upsell, monetize, cases, tutorials, external, merging, suppress, ids, visited, field, resolve, duplicate, cursor, ides, claude, chatgpt, command, routines, skills, ask, longer, guest, section, breaks, down, opens, clicks, tells, recipients, some, navigation, labels, think, audience, campaigns, familiar, parts, latest, request, log,

Text of the page (random words):
g push notifications set up push notifications set up rich push app groups for push tracking deep links push metrics sound in push notifications provisional push push service certificates test your push implementation in app messages set up in app messaging inline in app messages page rules in app event listeners notification inbox what s new 4 x 4 4 0 3 x 4 0 0 3 x 3 13 0 3 x 3 9 0 2 x 3 x 1x 2 x changelog ios quick start guide getting started how it works authentication packages and configuration options troubleshooting identify and track users identify profiles track events screen tracking mobile lifecycle events anonymous activity push notifications set up push notifications set up rich push deep links push metrics sound in push notifications provisional push push service certificates test your push implementation in app messages set up in app messaging inline in app messages page rules in app event listeners what s new 3 x 3 13 0 3 x 3 9 0 2 x 3 x 1x 2 x changelog ios get started identify profiles track events push notifications rich push notifications in app messages test support changelog ios get started identify profiles track events push notifications in app messages test support update from 2 10 to 2 11 migrate from an earlier version troubleshooting changelog android quick start guide getting started how it works authentication packages and configuration options troubleshooting identify and track users identify profiles screen tracking mobile lifecycle events anonymous activity track events location tracking push notifications push notifications deep links channel push service certificates test your push implementation in app messages in app messages in app event listeners inline in app messages page rules notification inbox what s new 4 x 4 10 3 x 4 x 2 x 3 x changelog android get started identify profiles track events push notifications in app messages test support migrate from an earlier version troubleshooting changelog android get started identify profiles track events push notifications rich push notifications test support migrate from an earlier version changelog react native quick start guide getting started how it works authentication packages and configuration options troubleshooting identify and track users identify profiles track events screen tracking mobile lifecycle events anonymous activity location tracking push notifications set up push notifications app groups for push tracking deep links handling multiple push providers capture push metrics android channels in app messages set up in app messages inline in app messages in app event listeners notification inbox what s new 6 x 6 4 0 5 x 6 0 0 4 x 5 0 0 4 x 4 3 3 4x 4 x 3 x 3 4 2 x 3 x changelog react native quick start guide getting started how it works authentication packages and configuration options troubleshooting identify and track users identify profiles track events screen tracking mobile lifecycle events anonymous activity push notifications set up push notifications deep links handling multiple push providers capture push metrics android channels in app messages set up in app messages inline in app messages in app event listeners what s new 4 x 4 3 3 4x 4 x 3 x 3 4 2 x 3 x changelog react native quick start guide getting started how it works authentication packages and configuration options troubleshooting identify and track users identify profiles track events screen tracking mobile lifecycle events anonymous activity push notifications set up push notifications deep links handling multiple push providers capture push metrics android channels in app messages set up in app messages inline in app messages in app event listeners what s new 4 x 5 0 0 4 x 4 3 3 4x 4 x 3 x 3 4 2 x 3 x changelog react native get started identify profiles track events push notifications set up push notifications deep links handling multiple push providers capture push metrics in app messages set up in app messages in app event listeners updates and troubleshooting migrate from an earlier version troubleshooting changelog react native get started identify profiles track events push notifications set up push notifications deep links handling multiple push providers capture push metrics in app messages set up in app messages in app event listeners updates and troubleshooting migrate from an earlier version update to version 3 4 troubleshooting changelog expo quick start guide getting started how it works authentication packages and configuration options troubleshooting identify and track profiles identify profiles track events screen tracking mobile lifecycle events anonymous activity location tracking push notifications set up push notifications app groups for push tracking deep links capture push metrics android channels multiple push providers in app messages inline in app messages notification inbox set up in app messages in app event listeners what s new 3 x 3 3 2 x 3 x 1x 2 x changelog expo get started identify profiles track events push notifications set up push notifications deep links capture push metrics in app messages set up in app messages in app event listeners updates and troubleshooting troubleshooting changelog flutter quick start guide get started how it works authentication configuration options troubleshooting identify track users identify profiles mobile lifecycle events anonymous activity screen tracking track events location tracking push notifications set up push notifications app groups for push tracking deep links handling multiple push providers capture push metrics android channels in app messages in app messages inline in app messages notification inbox in app event listeners what s new 3 x 4 0 0 3 x 3 5 0 2 x 3 0 0 2 x 2 2 upgrade to flutter 2 x changelog flutter quick start guide get started how it works authentication configuration options troubleshooting identify track users identify profiles mobile lifecycle events anonymous activity screen tracking track events push notifications set up push notifications deep links handling multiple push providers capture push metrics android channels in app messages in app messages inline in app messages in app event listeners what s new 2 x 2 2 upgrade to flutter 2 x changelog flutter get started identify profiles track events update flutter sdk push notifications set up push notifications deep links handling multiple push providers capture push metrics in app messages in app messages in app event listeners updates and troubleshooting update ios troubleshooting changelog settings billing account verification audit logs tasks workspace performance billing how we bill billing for sms messages billing for whatsapp messages ai credits reducing billing overages payment problems canceling your account plan features builder plan your account manage team members how to add team members assign standard roles create assign custom roles access multiple accounts edit account information customize your ui manage your api credentials security best practices two factor authentication single sign on sso account regions us and eu enable experimental features workspaces workspaces in customer io understand timezone conversion case sensitivity and your data search your workspace privacy security session cookies and expiration allowlist our ip addresses customer io gdpr and you security mobile and app store privacy privacy respecting your users privacy ai settings customer io security qualifications troubleshooting troubleshooting login and browser issues create a har file for help troubleshooting releases this page is part of the customer io documentation for the complete documentation index see llms txt you might not have access to this feature this feature is only available on our premium and enterprise plans talk to our team about upgrading your plan messaging objects data 3_collections md 45 collections premium this feature is available for premium plans enterprise this feature is available for enterprise plans updated july 15 2026 collections provide a way to store data in your workspace that you can use in automations with liquid what s a collection a collection is a new type of data in customer io that s separate from people or events in your account they represent any set of things that exist in your business for instance a collection could be a list of upcoming events promotions coupons or available classes you should store this data in customer io when it s helpful to be able to sort through the collection to identify a specific set of data that you want to include in a message tailored to the data you know about each person let s take the example of an online learning service by storing all the courses offered in a collection you could retrieve the specific set of classes that are relevant for each individual person and list them in an automation email collections are flexible they re simply lists of json objects that do not require specific schemas or indexes however your collection cannot be larger than 10 mb and rows in your collection are limited to 10 kb you cannot use collections with one time sends for now you can only take advantage of collections in automations create a collection you can upload your collection as json a csv file or by sharing a google sheet with us if you upload a csv file or share a google sheet we expect your file to be a simple table with headers each column is an attribute of your collection items to share a google sheet with us you must grant customer io access to specific files in your google drive for example if your collection contains a list of courses your csv might look like this name level description duration instructor introduction to python beginner learn the basics of python programming 4 weeks jane smith data analysis with r intermediate analyze datasets using r 6 weeks john doe advanced machine learning advanced deep dive into ml algorithms 8 weeks alice johnson each row represents an item in your collection and each column header becomes an attribute that you can reference in your messages collections must be smaller than 10 mb and you cannot have more than 50 collections in your workspace to add a collection under configure data click more collections and click add collection give your collection a name and description select your collection file json csv or google sheet click add collection use collection data in your messages now that you ve added a collection the next step is to use them in your automations the power of collections is that you can query the collection as part of an automation workflow meaning that you can retrieve only the collection items relevant to that particular person and automation add a query collection action when a person reaches this action the automation retrieves collection data and stores info based on your parameter then you can use this data in subsequent messages build a query to retrieve relevant info select the query collection action give it a name and click add query to get started let s build a query that retrieves course recommendations based on a profile s skill level choose a collection to query select the collection you want to query click add query condition to filter for the courses you want to send a message about for example you could filter for all courses where the collection attribute level is equal to the profile s attribute skill_level decide how to store the results under store the query results decide whether you want to use this information outside of the automation or not choose customer attribute to store data on the person s profile accessible outside of the automation choose journey attribute to store data temporarily during the journey this data expires when the person exits the automation keep the following limits in mind if you re setting journey attributes overall limit 100 journey attributes per journey you can create or change up to 100 journey attributes during a single journey updates beyond this limit fail and the profile moves forward without the update attribute name limit 128 bytes attribute value limit 100 kib then choose or create an attribute like course_recommendations we store data on this attribute as json preview the results choose a person from the sample data panel to preview the query results go to the preview tab to see what the collection rows would return for the sample user reference collection data with liquid now that you ve set up your query you can use the collection data in a message reference profile attributes for collection data stored as customer attributes reference them using the customer object for item in customer course_recommendations item name endfor if the data is an array you can use liquid filters such as first last and map to get specific items or attributes assign first_course customer course_recommendations first if you limited your query to a single result then the attribute value is an object not an array you can instead directly access the name and course description customer promo_course name customer promo_course description reference journey attributes for collection data stored as journey attributes reference them using the journey object for item in journey course_recommendations item name endfor if the data is an array you can use liquid filters such as first last and map to get specific items or attributes assign first_course journey course_recommendations first if you limited your query to a single result then the attribute value is an object not an array you can instead directly access the name and course description journey promo_course name journey promo_course description collections api the endpoints for collections are available via our app api us region https api customer io v1 eu region https api eu customer io v1 creating a new collection post v1 api collections create a new collection by providing both a name and either an array of json objects as data or a url to download csv or json data from name collection name data row row if you provide a url the data can either be json array or newline delimited or a csv file ensure that you provide a content type definition so that we know how to parse the data if you don t provide a content type we use the file extension if you don t include a content type or file extension we assume the url contains json you cannot share a google sheet with us using this api once created a collection has the following json definition bytes bytes_of_data_in_collection created_at 1589471110 updated_at 1589471132 id 1 name collection_name rows number_of_rows_in_collection schema name1 name2 name3 the schema will have a list of all attributes used by any items in the collection but remember that we don t enforce that all items have this set of attributes retrieve info about a collection you ve already created get v1 api collections id get the details of a collection with the given id this does not include the content retrieve the content of a collection you ve already created get v1 api coll...