--- title: "Understanding Segment Conditions" slug: "understanding-segment-conditions" tags: ["Loyalty and Referrals", "Shopify", "Shopify Plus"] updated: 2026-05-05T09:12:05Z published: 2026-05-17T14:00:00Z canonical: "support.yotpo.com/understanding-segment-conditions" --- > ## Documentation Index > Fetch the complete documentation index at: https://support.yotpo.com/llms.txt > Use this file to discover all available pages before exploring further. # Understanding Segment Conditions Products Loyalty ###### Supported plans Premium, Enterprise ###### eCommerce Platform Shopify, Shopify Plus, BigCommerce, Custom ## Segment Conditions Overview Segment conditions determine which customers are included or excluded from a segment. Each segment is made up of one or more conditions. You can build segments based on the following categories: - **Customer behavior**: Purchasing and transactional activity - **Customer attributes**: Account and profile information - **Loyalty & Referrals**: Loyalty and referral program data In this article, you’ll learn about the available segment conditions and data types in Yotpo Loyalty & Referrals. ## Data Types The operators available for each condition depend on its data type. The following data types are supported. ### String A string is a plain text value that can include letters, numbers, symbols, and punctuation. Available operators: - **Equals**: Matches the specified text - **Doesn’t equal**: Does not match the specified text - **Contains**: Contains the specified text - **Doesn’t contain**: Does not contain the specified text - **Starts with**: Starts with the specified text - **Ends with**: Ends with the specified text ### Date Date values represent date and time information. You can use a specific date or a relative date range. Available operators: - **Over all time**: Occurred at any point in time - **In the last**: Occurred in the last X days, months, or years (includes today) - **In the next**: Will occur in the next X days, months, or years (excludes today) - **Between**: Occurred between two selected dates - **Before**: Occurred before a selected date (excluding that date) - **After**: Occurred after a selected date (excluding that date) - **On exact date**: Occurred on the specified date ### Number A number is a numeric value without decimals. You can use a specific value or a range. Available operators: - **Equals**: Is exactly the specified number - **Doesn’t equal**: Is not exactly the specified number - **Is less than**: Is smaller than the specified number - **Is greater than**: Is greater than the specified number - **Is at least**: Is greater than or equal to the specified number - **Is at most**: Is less than or equal to the specified number ### Boolean Boolean values represent two possible states: true or false. They are commonly expressed as: - **Is / is not** - **Has / has not** ### List ![An example of a list data type](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/date-type-list-example.png?sv=2026-02-06&spr=https&st=2026-10-27T16%3A43%3A25Z&se=2026-10-27T17%3A43%3A25Z&sr=c&sp=r&sig=vGfHs%2BwsrwnbFXueNmmbqHUld2hgcbbxPkPff43YSSc%3D) A list is an array of predefined values. It is commonly used for statuses such as account status or payment status. ## Available Conditions ### Customer Behavior (Shopify Only Conditions) Customer behavior conditions relate to purchasing and transactional activity tracked by your eCommerce platform, such as placing orders and total spend. Available conditions include: - **Placed an order** (date): Customers who made a purchase within a selected time period. - **Ordered product/s** (list): Customers who purchased any of the selected products. - **Number of orders** (number): Total number of orders placed. - **Total spend** (number): Total amount spent in your store. ### Customer Attributes Customer attributes include information collected from your eCommerce platform and Yotpo, such as account status, tags, and segment membership. Available conditions for Shopify: - **Customer account** (boolean): Customers who have a store account, regardless if they’re logged in or [have a Shopify legacy account](https://support.yotpo.com/docs/using-yotpo-loyalty-referrals-with-shopifys-new-customer-accounts#shopify-customer-accounts-overview). - **Created account** (date): Date the customer created an account in your store. - **Shopify legacy customer account status** (list): Customers with a specific Shopify legacy account status. - **Tagged with** (string): Customer tags created in your store. Available conditions for Shopify and Non-Shopify: - **Part of a segment** (list): Customers who belong to one or more existing segments. ### Loyalty & Referrals Loyalty & Referrals conditions relate to a customer’s loyalty and referral program activity, including enrollment status, points, tiers, and referrals. Available conditions for Shopify and Non-Shopify: - **Loyalty member** (boolean): Customers enrolled in your loyalty program. - **Opted in** (date): Date the customer joined the loyalty program. - **Opted out** (date): Date the customer left the loyalty program. - **Engaged with the loyalty program** (date): Date the customer last interacted with the loyalty program. “Last interaction” refers to the most recent loyalty-related action performed by the customer, not the last time they visited your site. For example, earning points, spending points, qualifying purchases, or manual point adjustments. - **Points earned** (number): Total lifetime points earned. - **Points balance** (number): Current points balance. - **Points expiration date** (date): Date points will expire. - **Total number of redemptions** (number): Total number of redemptions the customer has made, including point-based redemptions, rewards issued for completing earning rules, VIP/loyalty tier entry rewards, and referral rewards. - **Redeemed points** (date): Most recent redemption date. Applicable to points-based redemptions only. - **Current VIP tier** (string): Current VIP tier status. - **Entered current VIP tier** (date): Date the customer entered their current tier. - **VIP tier expiration date** (date): Date the current tier expires. - **Total number of successful referrals** (number): Total number of successful referrals made by the customer, as defined in your Referral Program settings. - **Referred by customer** (boolean): Indicates whether the customer was referred by another customer. ### Reviews > [!NOTE] > Available for > > Merchants with an active Yotpo Reviews plan. Reviews conditions relate to a customer’s review activity and engagement, including whether they’ve submitted reviews, how many they’ve written, and the quality and sentiment of their feedback. Available conditions for Shopify and Non-Shopify: - **Submitted a review** (boolean): Indicates whether the customer has submitted a review within a specified timeframe. - (Optional) **Add filter**: For additional segmentation, you can filter by star rating, product reviewed, review source, or sentiment. - **Number of reviews** (number): Total number of reviews submitted by the customer. - (Optional) **Add filter**: For additional segmentation, you can filter by review type, such as product reviews, site reviews, positive reviews, or negative reviews. - **Average reviews sentiment** (list): The overall sentiment of reviews submitted by the customer, based on aggregated review data. - (Optional) **Add filter**: For additional segmentation, you can filter by review type, such as product reviews or site reviews. - **Average reviews star rating** (number): Average star rating of reviews submitted by the customer. - (Optional) **Add filter**: For additional segmentation, you can filter by review type, such as product reviews or site reviews. ## Deprecated Conditions This is the list of segment conditions that have been deprecated and no longer available after migrating to the latest Segments feature. ****Customer behavior**** - **Abandoned an order**: Customers who abandoned their cart within a selected period of time. - **Fulfilled order status**: Filter customers based on the status of their purchase. - **Order payment status**: Filter customers based on the status of their payment. ****Customer attributes**** - **Part of a list**: Contacts are part of a selected list. ****Location-based**** - **Located in specific country**: Target customers located in a selected country. - **Located in the EU**: Target customers located in the EU. ****SMS**** - **SMS subscriber**: Contacts who are subscribed to SMS. - **Subscribed from a specific source**: Segment contacts based on their subscription source. - **Part of a conversational flow**: Segment contacts based on conversational flows. - **Part of a SMS list**: Contacts are part of a selected text marketing list. - **Clicked an SMS link**: Subscribers who clicked a link in a text message sent via SMSBump. - **Converted via SMS** ****Predictive data**** - **Likely to purchase again**: The likelihood of a customer making a future purchase within the next 90 days based on predictive analytics. - **Churn risk**: The likelihood of a customer churning within the next 90 days based on predictive analytics. ## Using AND / OR Connectors #### AND connector Use **AND** to make your segment more specific. All connected conditions must be met for a customer to be included in the segment. Example: ![Segment conditions - AND example](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/segment-condition-example-AND.png?sv=2026-02-06&spr=https&st=2026-10-27T16%3A43%3A25Z&se=2026-10-27T17%3A43%3A25Z&sr=c&sp=r&sig=vGfHs%2BwsrwnbFXueNmmbqHUld2hgcbbxPkPff43YSSc%3D) A customer must have placed at least two orders **AND** placed an order within the last 30 days. Customers who meet only one condition will be excluded from the segment. #### OR connector Use **OR** to make your segment more inclusive. A customer only needs to meet one of the connected conditions to qualify for the segment. Example: ![Segment conditions - OR example](https://cdn.document360.io/f3c2ab59-fe4c-4f93-9614-2872f40e8aa7/Images/Documentation/segment-condition-example-OR.png?sv=2026-02-06&spr=https&st=2026-10-27T16%3A43%3A25Z&se=2026-10-27T17%3A43%3A25Z&sr=c&sp=r&sig=vGfHs%2BwsrwnbFXueNmmbqHUld2hgcbbxPkPff43YSSc%3D) A customer must have opted into your loyalty program **OR** placed at least one order. Customers who meet either condition will be included in the segment.