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 use an attribute named timezone in your users’ profiles. You can store time zone data in their profiles with a different attribute name, but in order to enable this feature, you need to use a timezone attribute and the right time zone format. This restriction help us ensure that the feature works correctly and lets us 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’ve sent us the 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 items in your workflows:

Choosing to use the user's time zone

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 timezone attribute, or if you disable the feature in the future:

Choosing a fallback time zone

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 setting on the individual Time Window action items.

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: