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.

1586

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.

1160

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 OptionAPI 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