📅 Understanding Group Filter Expressions on Time Fields in ConveYour

ConveYour allows you to create dynamic groups based on time-based events—such as orientation sessions, account creation, or other timestamped activities. This guide breaks down how time field expressions work and how you can use them to segment your audience based on past, present, and future activity (watch the video if TL;DR).

🧠 Key Concepts & Terminology

1. Time Field Requirement

To apply time-based filters, your data must include a time field. This might be a custom field like Orientation Time, or built-in fields like Created At.

2. Operators: Greater Than & Less Than

Greater Than (means after): Filters for entries after a certain point in time.
Less Than (means before): Filters for entries before a certain point in time.

3. Signs: Positive, Negative & Zero

+ (Positive): Indicates a point in the future (e.g., +14 days means 14 days ahead).
- (Negative): Indicates a point in the past (e.g., -14 days means 14 days ago).
0 (Zero): Represents right now, down to the second.

🧪 Example: Upcoming Orientation Group

To create a group of contacts whose orientation is scheduled within the next two weeks, you'd use:

Orientation Time is Greater Than 0 (after now)
Orientation Time is Less Than +14 days (before 14 days from now)

Explanation:

Greater Than 0 ensures the orientation is in the future.
Less Than +14 days limits the range to only the next 14 days, excluding events far in the future.

This filters in only those whose orientation time is between now and 14 days ahead.

⏮ Example: Last Orientation Group

To gather contacts who completed orientation in the past 14 days, you'd use:

Orientation Time is Less Than 0 (before now)
Orientation Time is Greater Than -14 days (after 14 days ago)

Explanation:

Less Than 0 ensures the event is in the past.
Greater Than -14 days ensures it's no more than 14 days ago.

This gives you a group of people who recently participated in orientation.

🕒 Time-Sensitive Precision

The system tracks not just dates, but hours, minutes, and seconds. A contact with an orientation time just a minute into the future would not match the “Less Than 0” (past) filter. This precision helps with high-stakes timing and automation.

🔄 Real-Time Group Updates

After updating a contact's time field:

Refresh the group view to see changes.
A contact will enter or exit a group based on whether their time field matches the filter expressions.

🔍 Bonus: Use `Created At` Field

You can apply the same logic to the default Created At field. For example:

Created At is Greater Than -7 days gives you all contacts who joined ConveYour in the past week.

💬 Need Help?

Tap the Help button in ConveYour to:

Ask the AI assistant for clarification
Reach out to support for personalized guidance

We’re here to help you filter smarter!