Using a date property to trigger a flow is a great way to set up a flow sequence around key dates you collect from subscribers. Common examples of date property-triggered flows include:
- Subscription date
- Wedding date
- Pregnancy due date
- Reorder product
In this article, we go over date property-triggered flows, including how they work and how to set one up.
Accepted Date Formats
Date-based flows are triggered by a date that is stored as a property within a profile. For example, a birth date can be stored as a custom property that you name as “birthday.”
When collecting date properties from your customers, the date needs to be in one of Klaviyo’s accepted date/time formats in order to trigger a flow; e.g., YYYY-MM-DD or MM/DD/YYYY. If the date is not in the correct date/time format or is listed in the text format, it will not appear as an option in, for example, a date-triggered flow.
When you don't see the date you want, this likely means that either there are no profiles with that property yet or the dates are improperly formatted. Check that at least one profile has that date and that it is formatted correctly.
If no profiles have that property yet, try adding it to a test profile. If that doesn’t work, or you see profiles with the correct date property already, please contact Klaviyo support to resolve this issue.
Create a Date-Based Flow
To create a date property-triggered flow, go to your Flows tab and then click Create Flow. This will take you to the Flows Library where you can find pre-built birthday and anniversary flows. You can find these flows by searching via the toolbar at the top of the library, or by navigating to the "Nurture Customers" and "Build Customer Loyalty" goals.
You can either select a pre-built flow or create one from scratch. To build it yourself, click Create from Scratch and choose the Date Property option as the initial trigger.
When you first choose the date property trigger, you will be prompted to select which specific property you would like to trigger the flow. All date-based profile properties in your account will appear in the dropdown menu for selection.
Pick When the Flow Will Start
After selecting a date-based profile property, you will need to choose when the flow should start: on or before the actual date. For example, a birthday flow can start sending messages to a recipient two weeks before their actual birthday. You can also have the flow begin after the date; for this, start the flow on the date and then add a time delay.
If you choose to start the flow before the date, you can select any number of days, weeks, or months in advance. This will automatically produce an anchor point (called the target date delay component) on the actual date. The anchor point works similarly to a time delay component except that instead of delaying for a certain amount of time, it delays until a certain date. This point also helps you keep track of where in the flow the date falls.
There can only be one target date anchor point in a date-based flow. Because of this, and because these flows are designed to reach the target date, any conditional split placed before this anchor point will be automatically rejoined. You will also not be able to disconnect any paths for a split that is before the anchor point.
Choose How Often the Flow Will Repeat
The final step to setting up a date-based flow is to choose how often the flow should repeat:
Recipients will qualify to enter this flow on a monthly recurring basis on the same day each month; for example, a monthly subscription reminder series. Note that if you schedule this on the 31st, it will automatically pick up on the last day of the month for any month that has fewer than 31 days.
Recipients will qualify to enter this flow on a yearly recurring basis on the same month/day; for example, a yearly anniversary or birthday series.
- Should not repeat
Recipients will qualify to enter this flow only once when the full date matches (day, month, and year); for example, a wedding or pregnancy due date.
Add Flow Filters
You can also choose to apply a flow filter during your initial setup to restrict the flow to only certain people, and you can add or adjust these filters at any time. For instance, if you want to have two wedding date flows — one for brides and the other for bridesmaids — you can exclude the brides from the bridesmaids’ flow and vice versa.
Drag in Messages and Time Delays
Next, add any time delays and emails or SMS messages to your flows. Both can go before and after the date anchor point.
Note that when using time delays in date-based flows, the component will look different depending on if it’s placed before or after the date anchor point. For more details, read this explanation on using time delays in date property-triggered flows.
Set the Flow to Manual or Live
When at least one message is in manual or live mode, Klaviyo will begin to check whether recipients should be added to the flow. Klaviyo checks all profiles in your account daily (and whenever a date is added, updated, or deleted) to ensure that anyone who is due to enter a date-based flow is queued for the date-based flow. This check runs a full day ahead of time so that no recipients miss out, regardless of what timezone they're in.
Read more about date-based flows: