Send messages in users' time zones with Time Zone Match aims to help you send the right messages at the right time to your users. A critical part of this is sending messages in a given person’s time zone, and localizing time in emails! Here, we’ll explain how to do both.

The timezone attribute

This is the most important part of setup!

In order to enable this feature, we ask that you pass us time zone values using the attribute customer.timezone. You can store time zone data with a different attribute name, but in order to enable this feature, you need to send it with customer.timezone. This restriction help us ensure that the feature works correctly and validate that time data is entering in the right format.

Enabling and using Time Zone Match

Head over to the Email & Actions area of, and find the Time Zone Match feature:

There, we’ll ask you to first test that you’re sending us the customer.timezone attribute in the right format. We support the regional format shown here, so something like Canada/Pacific will work, but (GMT-08:00) Pacific Time (US & Canada) will not pass. We require at least one successful test on a user before you can enable the feature:

Your messages can now send in your customers’ time zones!

In the workflow

One enabled, Time Zone Match becomes visible on the time window action in the workflow:

With this setting, you can tell to wait until a given time in a customer’s time zone to take action.

You must also set a fallback here, telling which time zone to use if a customer doesn’t have the time zone attribute, or if you disable the feature in the future:

That’s it!

Using time zone data in messages

If you want the time(s) in your messages to be localized, we can do that, too!

Say you want to send an appointment reminder, and you have an appointment_time timestamp. If that appointment time is a UNIX timestamp— for example, 2014113600—

    {{ customer.appointment_time | timezone: customer.time_zone | date: "%H:%M %A %b %d, %Y" }}

If customer.timezone is 'US/Pacific', then the above Liquid code will display:

Friday Oct 28, 2033 at 05:00 PDT

Disabling Time Zone Match

You can do this in your Email & Actions settings, the same place you enabled the feature:

Remember the fallback you set on the time windows? When you disable this feature, we’ll revert to that on the individual time window actions.

For example, if you set PST as a fallback on one time window and EST on another, those will look like this when Time Zone Match is enabled:

And then, when the feature is disabled:

Disable with caution: If you enable Time Zone Match again, time windows will not return to waiting for a user's time zone. You'll need to re-configure that option when you re-enable the feature.

A few more resources

For and time zones: