How to create segments with Composer

Composer is Klaviyo's AI marketing agent. It can build a segment from a plain-language description of the audience you want, so you spend less time assembling conditions by hand and more time deciding who to target. Composer drafts the segment, but you stay in control: you review it and save it yourself before it becomes part of your account.

You will learn

• How to describe the audience you want
• How to read the segment preview before you save
• How Composer tells new segments apart from ones you already have
• What to check before you save
• Where to go to build a more detailed segment yourself

Before you begin

You can create a segment on its own or as part of generating a campaign. To learn more about creating segments during campaign generation, see How to create campaigns with Composer.

Step 1: Describe the audience you want

Open Composer from within Klaviyo and describe the segment you want in plain language. The more specific you are about conditions, the closer the result will be. Strong prompts usually name three things:

• Who to include: The consent status or group you're targeting, such as profiles with email marketing consent.
• What they did or didn't do: The behavior that defines the audience, such as never having made a purchase, or having ordered 3 or more times.
• The timeframe: The window the behavior applies to, such as the last 90 days or all time.

Here are three prompts that work well:

• "Create a segment of all profiles with email consent who have purchased in the last 90 days but haven't opened an email in 30 days."
• "Create a segment of all profiles within 10 miles of Boston, MA who have never made a purchase."
• "Build a segment of repeat purchasers who have ordered 3 or more times in the last 6 months."

Composer works best with natural language, whole sentences rather than keywords. If a condition matters to you, say it explicitly. Leaving it out means Composer decides for you.

Step 2: Review the preview before you save

Composer returns a draft segment. Nothing is in your account yet. The preview shows three things:

• The segment name
• How many profiles currently match
• The conditions in plain language, grouped so you can see how they combine

The preview groups the conditions to show how they work together. A profile has to match every group, but within a single group it only has to match one condition. So if one group is "has email marketing consent" and another is "purchased in the last 90 days," a profile needs both to be included. If a single group holds "purchased in the last 90 days" and "visited the site in the last 30 days," either one is enough.

You can tell a new segment from an existing one by what the preview shows. A segment Composer just created displays its full definition for you to review. A segment that already existed in your account shows only its name, because there is nothing new to check.

Step 3: Save the segment

When the segment looks right, select Save. The button changes to View, and the segment is now in your account under Lists & Segments.

From there it behaves like any segment you built yourself. You can edit its conditions, use it as a campaign audience, or trigger a flow from it. Composer doesn't send anything to the segment or use it anywhere until you do.

To understand the conditions Composer used, or to build a more detailed segment yourself, see Getting started with segments for the fundamentals, and Advanced segmentation reference for the complete set of conditions and how they combine.

Tips

• Name your conditions explicitly: If consent, timeframe, or purchase history matters to you, say so in the prompt. Composer fills any gaps with its own assumptions.
• Use the profile count as your check: The count is the fastest way to tell whether Composer understood you. Compare it against roughly what you expected before you save.
• Revise the prompt rather than the segment: If the definition is well off, generate again with a clearer prompt instead of correcting conditions one at a time.
• Start from an audit finding: If a segment audit flagged a coverage gap in your account, describe that gap back to Composer as a segment to create.

FAQ