Send messages in users' time zones with Time Zone Match
Customer.io 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.
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 Customer.io in the right format.
Enabling and using Time Zone Match
Head over to the Email & Actions area of Customer.io, 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 Customer.io to wait until a given time in a customer’s time zone to take action.
You must also set a fallback here, telling Customer.io which time zone to use if a customer doesn’t have the time zone attribute, or if you disable the feature in the future:
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—
'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:
A few more resources
For Customer.io and time zones: