Skip to main content

Workflow step timings

Within step details, you can define when tasks are due or emails are sent - e.g. 7 days after the Workflow is applied to a customer

Written by Carly Hammond

Summary

  • When configuring a Workflow Template, you set timings for each step:

    • Task steps - state numbers of days to define when the task should start and when it should finish (via its duration)

    • Email steps - state ASAP, after manual approval, or a custom number of days

  • These dynamic references in Workflow Templates are replaced with actual dates when the Template is applied to a record (e.g. a specific Company or End User)

  • If just step timings are at play (no dependencies or conditions), the number of days counts from when the Workflow Template is applied (day 0)

Who is this article for?

  • Planhat builders (e.g. CS Ops), designing Workflow Templates for their team

Series

This article is part of a series on scheduling Workflows:

It is strongly recommended to read these in order, as they build in complexity, and later articles refer back to earlier ones.


Article contents

Click below to jump to the relevant section:


πŸ“Œ Important to note

This article assumes you have read Scheduling your Workflows, the first article in this series. If you haven't yet, please go through that article before this one.

What are step timings?

Within a Workflow Template, the easiest way to schedule when steps happen is by using the timings in the step details. For example, do the kick-off call on day 2, and hold the first set-up meeting on day 7.

You can combine step timings with dependencies and conditions (described in later articles in this series), but firstly, here in this article we'll look at simple timings by themselves. The number of days specified starts counting when the Workflow Template is applied to a record (e.g. a Company or End User).

This is what simple timings for email steps in a Sequence Workflow Template can look like:

Click on the image to view it enlarged

Considering task steps in a Project Workflow Template, simple step timings look like this:

When a Workflow Template is applied to a specific Company or End User etc. and the steps are activated, the actual dates are filled in - so if we take the Project example we just saw:

As you can see:

  • "Start After Days" in a Workflow Template defines the task "Start Date" in a Workflow

  • "Duration Days" (in combination with "Start After Days") defines the task "Due Date" in a Workflow

The date that the Workflow Template is applied (e.g. to a Company) is counted as day 0.

Our Step 1 in this example has "Start After Days" set to 1. If we apply this Workflow Template to a Company on April 30, the "Start Date" will be May 1 (as in, 1 day after April 30). As the "Duration Days" is 0, the "Due Date" is the same as the "Start Date".

Step 2 here has "Start After Days" set as 5 and "Duration Days" as 2, so when the Workflow Template is applied on April 30, the "Start Date" of this task is May 5 (April 30 + 5) and its "Due Date" is May 7 (May 5 + 2).

To read more about Task "Start Date" and "Due Date", you can refer to our separate article here.

πŸ“Œ Important to note

Remember, in this article we are just looking at time-based rules in isolation. It's possible to make a step a child of another (a dependent step), and/or apply rule-based conditions, and these would influence the timings - we'll go over dependent steps and conditions later in this article series.


Why use step timings?

Your Workflow will consist of multiple steps (actions), but you typically don't want all the steps to happen at once. Setting step timings is a really simple way for you to control when actions occur.

For example, perhaps you're creating an onboarding Project, which includes a series of meetings with a Company scheduled over several weeks; or maybe you're re-engaging with low adoption End Users via an email "drip campaign" Sequence, where you want to send emails spaced out every few days.

By specifying on each step what the timings should be, you can very easily state in a Project that you want the first training session to be 7 days after the Workflow Template is applied, and the next training session should be 14 days after the Workflow Template is applied. Or if you're sending a series of emails in a Sequence to inform new End Users about various features of your product, you can set the first email to be sent as soon as possible after the Workflow Template is applied, and then the next email to be sent 2 days after it's applied, and so on.

Here we've talked through some simple examples, but in other cases, you might want a step to occur a certain number of days after the previous step happened (e.g. sending an automated follow-up email after a meeting takes place) or after a rule-based condition has been met (e.g. emailing instructions of next steps only after the End User has taken a specific action such as logging in) - you can do this by combining step timings with dependencies and rule-based conditions, which we'll discuss later in this article series.


How to set up step timings

You set these timings in the step details (and/or in the steps table when looking at the overall Workflow Template), and the options vary slightly depending on whether it's a task step or an email step.

  • Task steps - this is configured via "Start After Days" and "Duration Days"

    • "Start After Days" - specify a number of days to count before the the step begins - this determines the "Start Date" of the task. 0 is the day the Workflow Template is applied (e.g. to a Company) and an individual Workflow record is created

    • "Duration Days" - specify a number of days that the task should take. Combined with "Start Date", this determines the task "Due Date" ("End Date" or "Finish Date" equivalent). 0 means that the task is expected to start and finish on the same day (e.g. an hour-long meeting). If you leave this as blank (-), it will count as 0

    • If you open up an individual task step to view its details panel on the right-hand side, you will also see a toggle switch "Only Workdays". If you enable this (set it to true), tasks won't be scheduled for weekends (Saturdays/Sundays)

  • Email steps - set this in the "Send when" box

    • You can choose whether your email is sent:

      • "As soon as possible"

      • "After manual approval" - emails will show in the "Outgoing - need action" tab of the Email Manager

      • "Custom" - if you select this from the dropdown menu, you can then select how many days or workdays to wait until the email is sent, and specify a specific time and time zone (which can be particularly useful if you're emailing a particular region, e.g. German emails to your German customers)


Next ...

Now you know all about simple step timings, let's add in the next layer of complexity: step dependencies.

Did this answer your question?