Email Timezones and Timestamps
Setting Timezones for Emails
Overview
Recurly's timezone for emails feature provides you full control to set a unique timezone specifically for the emails sent to your customer accounts. You can set an email timezone on the Site Settings page, which will then be applied to all of your customer accounts. Additionally, you can set an email timezone on each Account. If a customer Account has a unique email timezone specifically applied to their account, that setting will override the email timezone configured from Site Settings. Account-level email timezones can also be configured via the API. This will help ensure your varying customers receive email content sent via the Recurly App in their corresponding timezones, alleviating confusion of time/date stamp discrepancies between the Recurly "out-of-the-box" UTC email timezone provided for email content versus the appropriate timezone to reflect the customer's location.
Please Note!
It is important to note that this feature does not change the time an email is sent. Emails will still be sent as they are configured by trigger actions such as creating a subscription, making a purchase, receiving a refund, etc. This feature focuses on placing the source of truth for a customer's timezone within the email content itself, dynamically reflecting each unique customer's email timezone set to their account leveraging the email template parameters detailed in this documentation.
Example
Merchant 123 Inc. is located in New York, New York, with customer account Alex Smith based out of London, England. When the merchant sets Alex Smith's email timezone to GMT, that customer will now see the timezone/stamps associated with their subscription within an email reflected accurately, eliminating confusion around what day and time their subscription is intended to renew. 123 Inc. has the flexibility to set unique email timezones for each of their customer accounts, no matter where in the world they are located!
How to Configure Timezones and Timestamps for Emails via Recurly Admin UI.
On the “Site Settings” page, you are provided an option to set a time zone/time stamp for Emails at the bottom of the “Email Settings” section. The initial default option for all accounts site-wide is UTC. With this configuration, you can select any timezone from the dropdown to apply to all emails sent to all customers within your site.
You can also set a custom email timestamp/timezone for individual customers at the “Account” level. If an email time zone is selected for a specific customer on their account, Recurly App will prioritize that timezone over the site-wide email timezone configured on the “Site Setting” page.
If at any point you wish to remove a custom email time zone from a specific Account, you can select the "Site Settings (Default)" radio button and save your changes.
Site-Level Email Timezone Configuration
Configuring an email timezone/timestamp at the Site level will immediately send each email to each customer in the timezone you selected on this page. You can also set a custom email timezone at the Account-level, which will override the Site-level configured email timezone for a specific Account.
If you at any point wish to remove an Account-level custom email timezone, you can select the Site-level email timezone button on the account page and save your changes.

Account-Level Email Timezone Configuration
Configuring an email time zone at the Account-level will ensure that all emails the specific Account receives will contain the time zone and time stamp you applied to the given Account.
If you at any point wish to remove an Account-level custom email timezone, you can select the Site-level email time zone button on the account page and save your changes.

Additional email parameters
You can add the parameters below to your email templates within the Email Templates page in Recurly App.
- transaction_date_and_time
Transaction Date and Time (adjusted for timezone) - transaction_declined?
Show if given transaction was declined. - transaction_success?
Show if given transaction was successful. - transaction_voided?
Show if given transaction was voided. - subscription_expires_at_with_time
Date and Time (adjusted for timezone) when the subscription expires if the subscription has been canceled. - subscription_trial_ends_at_with_time
Date and time (adjusted for timezone) when the current subscription trial period ends.
Setting Account-specific Email Timezones via API
Supported API IANA Time Zone Names
The Account API accepts the following IANA time zone values for preferred_time_zone
:
Admin UI Option | API IANA Value |
---|---|
(GMT-12:00) International Date Line West (GMT-11:00) American Samoa (GMT-11:00) Midway Island (GMT-10:00) Hawaii (GMT-09:00) Alaska (GMT-08:00) Pacific Time (US & Canada) (GMT-08:00) Tijuana (GMT-07:00) Arizona (GMT-07:00) Mazatlan (GMT-07:00) Mountain Time (US & Canada) (GMT-06:00) Central America (GMT-06:00) Central Time (US & Canada) (GMT-06:00) Chihuahua (GMT-06:00) Guadalajara (GMT-06:00) Mexico City (GMT-06:00) Monterrey (GMT-06:00) Saskatchewan (GMT-05:00) Bogota (GMT-05:00) Eastern Time (US & Canada) (GMT-05:00) Indiana (East) (GMT-05:00) Lima (GMT-05:00) Quito (GMT-04:00) Atlantic Time (Canada) (GMT-04:00) Caracas (GMT-04:00) Georgetown (GMT-04:00) La Paz (GMT-04:00) Puerto Rico (GMT-04:00) Santiago (GMT-03:30) Newfoundland (GMT-03:00) Brasilia (GMT-03:00) Buenos Aires (GMT-03:00) Greenland (GMT-03:00) Montevideo (GMT-02:00) Mid-Atlantic (GMT-01:00) Azores (GMT-01:00) Cape Verde Is. (GMT+00:00) Casablanca (GMT+00:00) Dublin (GMT+00:00) Edinburgh (GMT+00:00) Lisbon (GMT+00:00) London (GMT+00:00) Monrovia (GMT+00:00) UTC (GMT+01:00) Amsterdam (GMT+01:00) Belgrade (GMT+01:00) Berlin (GMT+01:00) Bern (GMT+01:00) Bratislava (GMT+01:00) Brussels (GMT+01:00) Budapest (GMT+01:00) Copenhagen (GMT+01:00) Ljubljana (GMT+01:00) Madrid (GMT+01:00) Paris (GMT+01:00) Prague (GMT+01:00) Rome (GMT+01:00) Sarajevo (GMT+01:00) Skopje (GMT+01:00) Stockholm (GMT+01:00) Vienna (GMT+01:00) Warsaw (GMT+01:00) West Central Africa (GMT+01:00) Zagreb (GMT+01:00) Zurich (GMT+02:00) Athens (GMT+02:00) Bucharest (GMT+02:00) Cairo (GMT+02:00) Harare (GMT+02:00) Helsinki (GMT+02:00) Jerusalem (GMT+02:00) Kaliningrad (GMT+02:00) Kyiv (GMT+02:00) Pretoria (GMT+02:00) Riga (GMT+02:00) Sofia (GMT+02:00) Tallinn (GMT+02:00) Vilnius (GMT+03:00) Baghdad (GMT+03:00) Istanbul (GMT+03:00) Kuwait (GMT+03:00) Minsk (GMT+03:00) Moscow (GMT+03:00) Nairobi (GMT+03:00) Riyadh (GMT+03:00) St. Petersburg (GMT+03:00) Volgograd (GMT+03:30) Tehran (GMT+04:00) Abu Dhabi (GMT+04:00) Baku (GMT+04:00) Muscat (GMT+04:00) Samara (GMT+04:00) Tbilisi (GMT+04:00) Yerevan (GMT+04:30) Kabul (GMT+05:00) Ekaterinburg (GMT+05:00) Islamabad (GMT+05:00) Karachi (GMT+05:00) Tashkent (GMT+05:30) Chennai (GMT+05:30) Kolkata (GMT+05:30) Mumbai (GMT+05:30) New Delhi (GMT+05:30) Sri Jayawardenepura (GMT+05:45) Kathmandu (GMT+06:00) Almaty (GMT+06:00) Astana (GMT+06:00) Dhaka (GMT+06:00) Urumqi (GMT+06:30) Rangoon (GMT+07:00) Bangkok (GMT+07:00) Hanoi (GMT+07:00) Jakarta (GMT+07:00) Krasnoyarsk (GMT+07:00) Novosibirsk (GMT+08:00) Beijing (GMT+08:00) Chongqing (GMT+08:00) Hong Kong (GMT+08:00) Irkutsk (GMT+08:00) Kuala Lumpur (GMT+08:00) Perth (GMT+08:00) Singapore (GMT+08:00) Taipei (GMT+08:00) Ulaanbaatar (GMT+09:00) Osaka (GMT+09:00) Sapporo (GMT+09:00) Seoul (GMT+09:00) Tokyo (GMT+09:00) Yakutsk (GMT+09:30) Adelaide (GMT+09:30) Darwin (GMT+10:00) Brisbane (GMT+10:00) Canberra (GMT+10:00) Guam (GMT+10:00) Hobart (GMT+10:00) Melbourne (GMT+10:00) Port Moresby (GMT+10:00) Sydney (GMT+10:00) Vladivostok (GMT+11:00) Magadan (GMT+11:00) New Caledonia (GMT+11:00) Solomon Is. (GMT+11:00) Srednekolymsk (GMT+12:00) Auckland (GMT+12:00) Fiji (GMT+12:00) Kamchatka (GMT+12:00) Marshall Is. (GMT+12:00) Wellington (GMT+12:45) Chatham Is. (GMT+13:00) Nuku'alofa (GMT+13:00) Samoa (GMT+13:00) Tokelau Is. | Etc/GMT+12 Pacific/Pago_Pago Pacific/Midway Pacific/Honolulu America/Juneau America/Los_Angeles America/Tijuana America/Phoenix America/Mazatlan America/Denver America/Guatemala America/Chicago America/Chihuahua America/Mexico_City America/Mexico_City America/Monterrey America/Regina America/Bogota America/New_York America/Indiana/Indianapolis America/Lima America/Lima America/Halifax America/Caracas America/Guyana America/La_Paz America/Puerto_Rico America/Santiago America/St_Johns America/Sao_Paulo America/Argentina/Buenos_Aires America/Godthab America/Montevideo Atlantic/South_Georgia Atlantic/Azores Atlantic/Cape_Verde Africa/Casablanca Europe/Dublin Europe/London Europe/Lisbon Europe/London Africa/Monrovia Etc/UTC Europe/Amsterdam Europe/Belgrade Europe/Berlin Europe/Zurich Europe/Bratislava Europe/Brussels Europe/Budapest Europe/Copenhagen Europe/Ljubljana Europe/Madrid Europe/Paris Europe/Prague Europe/Rome Europe/Sarajevo Europe/Skopje Europe/Stockholm Europe/Vienna Europe/Warsaw Africa/Algiers Europe/Zagreb Europe/Zurich Europe/Athens Europe/Bucharest Africa/Cairo Africa/Harare Europe/Helsinki Asia/Jerusalem Europe/Kaliningrad Europe/Kiev Africa/Johannesburg Europe/Riga Europe/Sofia Europe/Tallinn Europe/Vilnius Asia/Baghdad Europe/Istanbul Asia/Kuwait Europe/Minsk Europe/Moscow Africa/Nairobi Asia/Riyadh Europe/Moscow Europe/Volgograd Asia/Tehran Asia/Muscat Asia/Baku Asia/Muscat Europe/Samara Asia/Tbilisi Asia/Yerevan Asia/Kabul Asia/Yekaterinburg Asia/Karachi Asia/Karachi Asia/Tashkent Asia/Kolkata Asia/Kolkata Asia/Kolkata Asia/Kolkata Asia/Colombo Asia/Kathmandu Asia/Almaty Asia/Dhaka Asia/Dhaka Asia/Urumqi Asia/Rangoon Asia/Bangkok Asia/Bangkok Asia/Jakarta Asia/Krasnoyarsk Asia/Novosibirsk Asia/Shanghai Asia/Chongqing Asia/Hong_Kong Asia/Irkutsk Asia/Kuala_Lumpur Australia/Perth Asia/Singapore Asia/Taipei Asia/Ulaanbaatar Asia/Tokyo Asia/Tokyo Asia/Seoul Asia/Tokyo Asia/Yakutsk Australia/Adelaide Australia/Darwin Australia/Brisbane Australia/Melbourne Pacific/Guam Australia/Hobart Australia/Melbourne Pacific/Port_Moresby Australia/Sydney Asia/Vladivostok Asia/Magadan Pacific/Noumea Pacific/Guadalcanal Asia/Srednekolymsk Pacific/Auckland Pacific/Fiji Asia/Kamchatka Pacific/Majuro Pacific/Auckland Pacific/Chatham Pacific/Tongatapu Pacific/Apia Pacific/Fakaofo |
Updated 8 months ago