Wait Until...

Use the Wait Until item to hold a person in a campaign until they meet a condition or enter a segment.

Set up a Wait Until

You can set three different types wait delays: conditions (attributes, event properties, segments, etc), event time, and max time. You can use wait delays in tandem, but a person will progress in your campaign when they meet any type wait. For example, if you set attribute conditions and a max time, a person will progress in your campaign if they either meet your attribute conditions or they reach the maximum wait time.

  1. Drag Wait Until… into your workflow.
    image.png
    image.png
  2. Click it and determine the conditions a person must meet before they continue the campaign. You can choose one or more types of conditions. However, a person will proceed through the campaign when they meet any of the following:
    • Conditions: Attribute, event, segment, or message conditions that a person must meet (or not meet) to move on. Multiple conditions are joined with And—a person must meet all conditions to satisfy the wait.
    • Event time: A timestamp specified in an event that triggers your campaign.

      This timestamp can be a Unix or For example, if you trigger your campaign with an event called event_reminder you could Wait until the remind_me_at timestamp in your event to send a reminder message.

    • Max. time: The maximum time that a person can wait before moving on in the workflow.
      wait until supports 3 different types of conditions
      wait until supports 3 different types of conditions

After you’ve set it up, your Wait Until shows how many conditions a person must achieve before moving on.

image.png
image.png

Conditions

When you set your Wait until delay, you can use attribute, event, segment, or message conditions. You can event use different types of conditions in tandem. Multiple conditions are joined by an And: a person must meet all conditions to satisfy the wait.

  • Attribute: Wait until a person matches a profile attributeA key-value pair that you associate with a person—like their name, the date they were created in your workspace, etc. Use attributes to target people and personalize messages. condition—whether a person has an attribute, doesn’t have an attribute, matches an attribute value, etc.
  • Event: Wait based on whether a person has, or has not, performed an event. Unlike Event time delays, this does not have to be an event that triggered your campaign.
  • Segment: Wait based on whether or not a person belongs to a segment. See the Not in segment condition for more information about matching folks who aren’t in a segment.
  • Message: Wait based on whether or not a message has been sent. You can wait based on other campaigns, transactional messages, etc. For example, if you base an campaign that follows up on a person’s order, you might wait until after they receive a transactional message containing their receipt.

Event time

If your campaign is triggered by an event, you can wait until a timestamp value in your event before moving on to the next step in your workflow. For example, if you trigger your campaign with an event called new_appointment you could Wait until the day before the appointment_time in your event to send a message reminding a person about their upcoming appointment.

The timestamp in your event can be either:

  • Unix timestamp (in seconds)
  • RFC 8601-formatted time (e.g. 2022-06-04T10:24:34-0400).

If the timestamp you specify doesn’t exist, or is incorrectly formatted, a person will progress immediately past the wait. Unlike event conditions, you can’t base this time on another event. Your timestamp value must be a part of the event that triggers your campaign.

 If the timestamp doesn’t exist, people won’t wait

If you send an event that either doesn’t contain the timestamp specified in your wait, or the timestamp is incorrectly formatted, your audience will skip the wait and progress through the campaign immediately.

The Max time fallback

By default, people will wait until they meet your conditions. If they never meet your conditions, they could get stuck waiting in your campaign forever! Use the Max time option to let people exit the campaign or move on to the next action.

In this example, if a person isn’t in the specified segment after one week, they’ll move on to the next action in the workflow.

Set a wait until item with a max time
Set a wait until item with a max time

Segment “Not in…” conditions

Be careful when using a not in segment condition. This kind of condition will only hold people if they belonged to the segment already.

If you base your wait condition on whether people are not in a segment, people who were never in the segment will skip the wait. If people are already in the segment, they’ll wait until they can leave it.

an example of a wait until not in segment condition
an example of a wait until not in segment condition

Combinations of Wait Until

You can combine different types of waits—the categories below A person should wait until…. but person only needs to satisfy one type of wait to progress through your campaign.

If you set multiple wait Conditions, a person must satisfy all the conditions to progress through the wait. You might set up different wait types so that your audience doesn’t get stuck in your campaign—like, a set of Conditions a person must meet or a Max time that lets a person continue the campaign if they never meet the right conditions.

Example delay and wait

You might combine a delay and a wait, but pay attention to the order of your delay and wait blocks, so that you don’t make people wait unnecessarily in your workflow. For example, you might set up a delay and wait such that your workflow has the following blocks:

  1. Delay 7 days
  2. Wait until person enters a segment
  3. Email

In this case, people will wait seven days,and then as long as it takes to enter your segment. In this case, a person will always wait at least 7 days before progressing to the email in your campaign, but they could wait longer after that.

However, you might set the delay after the wait, making sure that people wait exactly 7 days after satisfying the wait condition.

  1. Wait until user enters segment
  2. Delay 7 days
  3. Email

Example wait and time window

Time windows and wait delays both use conditions to determine when a person progresses in your campaign. You might change the order of a time window and wait depending on whether you want to prioritize the time condition or your wait conditions.

Time Window first

  1. Wait for time window: Monday between 9AM and 5PM
  2. Wait until user enters segment
  3. Email

In this case, people wait until Monday at 9AM, and then move into the Wait until block. They’ll then wait as long as it takes for them to meet the segment condition before they receive an email. If people are not in the segment between 9 and 5 on Monday (even if they’ve entered and left it before), they won’t receive the email.

Wait Until first

  1. Wait until user enters segment
  2. Wait for time window: Monday between 9AM and 5PM
  3. Email

In this case, people will wait until they enter the segment, and then begin waiting for Monday at 9AM (assuming it isn’t already that time). If the user stops matching the ‘Paying Customers’ segment condition while they’re waiting for the time window, they will still get the email on Monday at 9AM.

Editing a Wait Until

You can edit the conditions of your Wait Until; just be aware that doing so might cause people to quit waiting.

For example, if you change an Event time condition from seven days that is then reduced to two days:

  • People who have already waited more than two days will move on (or exit the campaign)
  • People who have not yet waited two days will continue waiting

Deleting a Wait Until

If you delete a Wait until, you can choose what to do with anybody currently waiting.

  • Continue to the next action in the campaign
  • Exit the campaign immediately

It’s up to you! If people have been waiting a long time, you may not want to continue sending messages in the campaign.

Copying a Wait Until

It’s easy to copy the Wait Until between campaigns within the same workspace, because your segment conditions remain the same.

If copying between workspaces, you’ll need to re-add your conditions, and we’ll show you a warning note both in the workflow and when editing the item.

Copied to clipboard!