Introducing an all new email notification template

For any of you that have submitted tickets to support@zendesk.com recently, you'll have noticed that the response you get back looks very different from emails sent out of your account. We've been working on it for a while, and now we're ready to reveal our new and improved email notification template!

What's new and what does it look like?

The current email template has been in Zendesk since the beginning, we hadn't yet changed much about it at all. When we sat down to think about how we wanted to improve things, we settled on 3 aims:

  1. Come up with a template which is completely clean. It should look good without any branding, but allow branding headers and footers to be added if so desired
  2. Make it absolutely clear who each comment is from, what type of comment they're making (private or public), what they look like and who they are in Zendesk (agent or customer)
  3. Be readable for slow and faster readers, as well as comfortable on mobile devices
We came up with something that I think will fit everyones' needs, and is a great improvement over the existing template you may still be using. Here's a complete overview:
email_template.png

How do I get this in my account?

For accounts created before July 12th, 2012 this is an opt-in enhancement, which means there are a few things you'll need to do in order to get this new template design.

Here's the steps:

  1. As an Administrator of your Zendesk account, go to Settings > Channels and then "Email".
  2. Scroll down to the "Email templates" section.
  3. If you've made any customization to the existing, legacy template then you may want to copy and paste this somewhere in order to back it up.
  4. Check the "Enable modern template" option.
  5. This will load-in one additional option, "Show user profile photos in email". This will show agent and customer avatars either from your account or using Gravatar. We highly recommend enabling this, as it leads to a far more personal experience for your customers.
  6. When "Enabled modern template" is checked, the markup you see in "HTML Template" is the new template. You're welcome to customize the entire contents of this box, and if you go wrong you can simply hit "Revert to default" at the bottom of the box.
  7. When you're ready, click "Save Tab". Note: you will lose the "old" email template by doing this.
Once you've completed Step 7, any new outbound email will use the newer template.

Additional tips

The new template hasn't changed too much from the existing one, but here are a few tips to understand the subtleties between them.

  • There is not a link to the ticket in the email template. We believe the email template should be about design, not content. Most standard triggers that send out email notifications have links to the ticket - but if you've removed this you'll want to add that back in.
  • Try not to go too wild with branded headers and footers. Remember that in email, a lot of people will not see images you embed, because they'll be turned off by default in almost all mail clients unless customers white list you (which is, unfortunately, unlikely). This is not something Zendesk has control over.
  • While you can use styles in the template using <style>...</style> we recommend against it. Most of the time mail clients will completely strip this out so your customers won't see a lot of styling you've added. This is not something Zendesk is doing, or has control over.
Have more questions? Submit a request

Comments

  • Avatar
    Arnaud de Theux

    Great news, I liked this new design when contacting Support.

  • Avatar
    Kevin Hill

    I like the new design, but it would be nice to be able to hide the ticket info from the bottom. In our case, we customized the email templates a while ago to show ticket field information at the top of every notification, even for requesters. And we don't use the standard "Priority" fields, so having that in the footer of the notification is a waste of space for us.

  • Avatar
    Carsten Falborg

    Awesome... Been looking forward to getting that template... Looking good...

  • Avatar
    Toan

    Is it possible to customize the {{footer}} ?  It looks hard coded.  I'd love to be able to add custom fields to it and remove some of the default fields we need to see. 

    We've been crudely relying on periods / dots to manually align the text, but it still looks unprofessional.  Or if possible, it'd be great if there was a way to change the font in our trigger text content.

  • Avatar
    David Kapell

    I second Toan's question.  We'd love to see custom fields included, and some of the base ones removable.

  • Avatar
    Marc Perry

    In the article, you "highly" recommend enabling gravatars to show up in the new email template for a more personal experience, but then under additional tips you note the problem that most email client do not accept images.  This seems like contradictory information.  Do you still support showing gravatars despite the image email client issue?

    The new email template looks great.  Thank you!

     

  • Avatar
    David Spence

    This is great! How can we add the users Organization to the info, this will make things easier for agents to take tickets based on the Organizations they are responsible for:

    | Ticket #
    | 12345
    |
    | Status
    | New
    |
    | Requester
    |  NAME
    |
    | CCs
    | -
    |
    | Group
    | -
    |
    | Assignee
    | -
    |
    | Priority
    | -
    |
    | Type
    | Incident
    |
    | Channel
    | -
    |

  • Avatar
    Thomas Andersen

    Can we use the same code in the text template? 

  • Avatar
    Tom Corbett

    @Zendesk Great to see you guys release this :-)

  • Avatar
    Jake Holman

    Hello everyone!

    Thanks for much for the feedback so far, and I'm glad everyone seems to be enjoying the new layout.

    @Toan, Dave: About the agent footer, we hear you and will look into adding custom fields and removing fields that are deactivated on your account. We'll also look into actually hyperlinking content where applicable (such as the organization, requester, etc). As it stands right now we're not going to be opening up customization to that section yet.

    @Thomas, Marci, Gary, Lisa, Joey, Brett: Thanks for the feedback about "(agent)", you're certainly not alone in that feedback. Given the reaction to it so far, we'll be completely removing the string. We originally only had it showing to agents, but opened this up to end-user visibility thinking it would be beneficial.

    We may have been naive to think that everyone refers to their staff as "Agents", but had to settle on one reference to it. The reason we didn't implement it as a customizable feature is two fold:

    1. We offer all generated email content in multiple languages. Pretty much everything we _write is internationalized and localized. As soon as we open up the ability to customize this one word, you lose that feature completely. _You may not be using our localized capabilities, but many others are
    2. Where possible we'll always try and keep the number of settings down

    Given the removal of the agent title, I'll be cleaning up these comments to remove reference so as not to confuse future readers. 

    We are considering replacing the agent title with something else in the future, perhaps the name of your company, so this would appear as:

    Jake Holman (Zendesk) 

    For example. A company name is rarely localized, and it's customizable!

    @Thomas: The "Text Template" is for the plain text portion of the email, something that's rarely seen unless you email client is set up to not read HTML emails. Putting this template in there would not work, as it would appear as written, and not in the richness you would expect. This is not a limitation of Zendesk, but simply how email in general works. See http://en.wikipedia.org/wiki/MIME for more info.

    @Marc: You're correct, it's somewhat contradictory. The same rule would apply since it's just an image, so they would not be visible by default in most email clients. But hey, at least the people that would turn on images would see that smiling face with the lovely rose bushes behind you, so your choice!

    Keep the feedback coming!

  • Avatar
    Jake Holman

    @Gary: Almost forgot. The time should be showing in the appropriate time zone of the recipient. We did notice some bugs around this (as well as some locale related stuff) and will be fixing very soon.

  • Avatar
    Gary Lavin

    @Jake Company name in place of Agent works for us.

  • Avatar
    Marci

    @Jake - Thanks for the response!

    Actually, I would like to vote that the (agent) string stays in!! I find it VERY helpful to have it there, just as it shows in the graphic above -- as a way to easily tell which comments are from agents. I LOVE this!!

    Changing the word from "agent" is all I needed to do, and it's now PERFECT. I hope it doesn't go away -- unless there remains a way to put something equivalent in it's place -- maybe using Liquid?

  • Avatar
    Kristina Hall

    In our old email template, we had our company logo at the top - is this something I'm able to add to this new template? If so, what code do I use and where in the HTML for the modern template do I place it? Thank you :)

  • Avatar
    Jake Holman

    @Kristina: You're still able to place your logo into the template if you wish. Unfortunately I'm unable to help you with custom HTML, but if you email support@zendesk.com they should be able to help you out.

  • Avatar
    Kristina Hall

    Thank you Jake!

  • Avatar
    Thomas Andersen

    @Jake: Thanks for elaboration.

  • Avatar
    Philip Moy

    I'm finding that a lot of the images/logos i upload for profile pictures in ZenDesk look great, but the quality looks degraded in the new email template. I was directed by support to reupload at 80x80px 72dpi but it seems to still be having the same effect. Is there anything i can do to compensate for the size change? 

    It also might be good to post the upload image recommended specs where you can add profile pics. Thanks!

  • Avatar
    Jake Holman

    @Philip: I'd recommend 200x200 (the 1:1 size ratio is important here). However, this can also be dependent on the rendering engine used by your mail client, or if you use an online service like Gmail, the rendering engine of your browser. They all handle downscaling differently.

    It also points out something we need to start doing, which is to enforce 1:1 size ratios at upload, allowing both end-users and agents to crop images on upload.

  • Avatar
    Rory Kingan

    Switching to the new format removes the link to the ticket, as you noted. CC notifications appear to not have the ticket link and so far as I can tell there's no way to change the content of the CC notification email, is that correct? Does that mean if we want CCs to have a link to the ticket it needs to go in the trigger template? If so I think it'd be worthwhile mentioning that above in the note about the ticket link being removed. Lots of our users have come to rely on those links and are now complaining that they're not there.

  • Avatar
    Jake Holman

    @Rory: oversight on my part, sorry about that. I'll be adding the link into the CC template right away, sorry about that.

  • Avatar
    Jake Holman

    Alright, I've just updated the default text of the CC notification. You can also do this by going to Settings > Tickets > "CC" section - here you can add in a placeholder to render the ticket link, such as  {{ticket.url}}

    This is the standard CC notification text as it stands now:

    You are registered as a CC on this help desk request ({{ticket.url}}) and thus receiving email notifications on all updates.

    Reply to this email to add a comment to the request.

    {{ticket.comments_formatted}}

    Again, this is completely customizable in Settings > Tickets > "CC" section.

  • Avatar
    Rory Kingan

    Great, thanks Jake. I assume this might affect email-only helpdesks (which isn't us but I thought I'd mention in case it means changes for someone somewhere else too).

  • Avatar
    Brad Campbell

    Does the  {{ticket.comments_formatted}} placeholder tag work in email templates? Currently I'm trying to get the new option of showing the users photos in emails to work in our custom email template. Our problem is that the comments seem to be getting placed outside of the HTML of our template. The most recent comment is the only one that is displaying correctly. Is there a way to fix this or a placeholder tag we can use?

  • Avatar
    Jake Holman

    The only supported placeholders are {{delimiter}} which displays the "Please reply above this line" text, {{footer}} which contains text along the lines of "This is an email service from {accountName}" which is localized, and then {{content}} which contains any content passed to it by a trigger, automation or anything else that sends emails from your account.

    The email template does not take any other placeholder. You control the layout of information within Triggers and Notifications, you can see an article here:  https://support.zendesk.com/entries/20011606-streamlining-workflow-with-ticket-updates-and-triggers or if you continue to have issues, don't hesitate to contact support@zendesk.com

  • Avatar
    Pierre Chevalier

    First, congratulations for the new layout. Love it. But I just had a complain from agents about the size of the font of the {{ticket.comments_formatted}}  placeholder, it has a 14px font size, whereas the rest is 12px. They then complain that they can not see enough at once. I checked the email CSS but could not find any reason why it is like that. Is there any way to change that font size? Thanks!

  • Avatar
    Jake Holman

    @Pierre: At the moment there's no way to customize much in the way of styling for the email template. We increased the font size from 12 to 14px mainly for the purpose of readability and quick scanning. We had the same reaction internally when we first switched, but found it was simply a standard reaction to change most people have, and everyone quickly adjusted.

    Hopefully your agents will get used to the changes rapidly, and realize it's certainly much easier to read now than it was.

  • Avatar
    Jake Lehner

    Hey Jake. I've been having some struggles getting a customer template to format properly in Gmail. I don't know if it has anything to do with the new email template, or just email in general.

    Ticket # is 249660 if you care to take a look in case you have some knowledge to share with the support team.

  • Avatar
    Jake Holman

    @Jake: I'll take a look, will respond in the ticket. Might take me a little while to get back to you.

  • Avatar
    Kathryn

    @Jake - I see in one of the earlier comments that you were modifying the CC template to include a link to the ticket - but for some reason it's not showing up for me.  I tested this out by CC'ing another email address of mine on a ticket - and although I received the email containing the ticket comment thread (very clean format by the way), I am not able to see a link to the ticket.  Is there a setting I need to change?

Article is closed for comments.