Skip to content

Instantly share code, notes, and snippets.

@elidickinson
Last active November 27, 2023 14:55
Show Gist options
  • Star 66 You must be signed in to star a gist
  • Fork 8 You must be signed in to fork a gist
  • Save elidickinson/9424116 to your computer and use it in GitHub Desktop.
Save elidickinson/9424116 to your computer and use it in GitHub Desktop.
HTML email buttons that work
<div>
<!--[if mso]>
<v:roundrect xmlns:v="urn:schemas-microsoft-com:vml" xmlns:w="urn:schemas-microsoft-com:office:word" href="http://www.EXAMPLE.com/" style="height:40px;v-text-anchor:middle;width:300px;" arcsize="10%" stroke="f" fillcolor="#d62828">
<w:anchorlock/>
<center style="color:#ffffff;font-family:sans-serif;font-size:16px;font-weight:bold;">
Button Text Here!
</center>
</v:roundrect>
<![endif]-->
<![if !mso]>
<table cellspacing="0" cellpadding="0"> <tr>
<td align="center" width="300" height="40" bgcolor="#d62828" style="-webkit-border-radius: 5px; -moz-border-radius: 5px; border-radius: 5px; color: #ffffff; display: block;">
<a href="http://www.EXAMPLE.com/" style="font-size:16px; font-weight: bold; font-family:sans-serif; text-decoration: none; line-height:40px; width:100%; display:inline-block">
<span style="color: #ffffff;">
Button Text Here!
</span>
</a>
</td>
</tr> </table>
<![endif]>
</div>
@elidickinson
Copy link
Author

Blog post explaining this HTML Email Button is here: http://www.industrydive.com/blog/how-to-make-html-email-buttons-that-rock/

@kllarkin
Copy link

New to downlevel-revealed conditional comment, but this blog post was a huge help in setting up rounded buttons for the first time. I have one question about the code above, as soon as I dropped all of the conditional comments into my file within Dreamweaver the table disappears completely in the design preview. Any insight as to why? Everything was showing until I placed the final tag in. Not sure where to begin on what I'm missing. Thanks in advance for any help you might be able to give!

@elidickinson
Copy link
Author

@kllarkin That comment formulation was causing problems in Outlook.com (formerly hotmail) too. It's all tradeoffs. I just updated the gist, see if that works better for you. Instead of wonky comments, now we're using technically invalid tags that should be ignored by everything except Microsoft products.

@elidickinson
Copy link
Author

I've explained the changes to the downlevel comments in more detail here: http://esd.io/blog/html-email-buttons-conditional-comments.html

@kllarkin
Copy link

@elidickinson Thank you! That change allowed the button to show in Dreamweaver preview pane. Had also noticed the issues in Outlook.com and will rerun all my tests today to confirm this fix there as well.

@elidickinson
Copy link
Author

I moved the button text color declaration to a span inside the anchor tag so that the color shows up correctly in Outlook Web App aka Office 365. This is different from Outlook.com, which has always worked.

@milesstewart88
Copy link

Perfect!!!

@SethHamilton
Copy link

You can avoid the MSO conditional around the "normal" button in the table if you wrap the table in a div, and put the style "mso-hide: all;" in div, the table, and it's TD.

@timbuguet
Copy link

@elidickinson Thank you, really nice button ! It definitely work on outlook Web App /O365 and Outlook 2010. However I did a litmus test and the rounded corners do not display on Outlook 2003. An tips ?

@elidickinson
Copy link
Author

@SethHamilton I'm pretty sure "mso-hide: all;" fails when a message is forwarded in Outlook, resulting in every button appearing doubled.

@KrunchMuffin
Copy link

the button isn't being centered in Outlook clients. How can I fix that?

n/m, I just put the MSO code inside a centered table and that seemed to fix it.

@codespore
Copy link

@elidickinson Seems to only work when wrapped with these instead (To show for all except outlook)

<!--[if !mso]><!-- -->
  <table cellspacing="0" cellpadding="0"> <tr> 
  <td align="center" width="300" height="40" bgcolor="#d62828" style="-webkit-border-radius: 5px; -moz-border-radius: 5px; border-radius: 5px; color: #ffffff; display: block;">
    <a href="http://www.EXAMPLE.com/" style="font-size:16px; font-weight: bold; font-family:sans-serif; text-decoration: none; line-height:40px; width:100%; display:inline-block">
    <span style="color: #ffffff;">
      Button Text Here!
    </span>
    </a>
  </td> 
  </tr> </table> 
<!--<![endif]-->

@francisngo
Copy link

<div>
  <!--[if mso]>
                      <v:roundrect xmlns:v="urn:schemas-microsoft-com:vml" xmlns:w="urn:schemas-microsoft-com:office:word" href="#" style="height:45px;v-text-anchor:center;width:550px;" arcsize="10%" stroke="f" fillcolor="#292929">
                        <w:anchorlock/>
                        <center style="color:#ffffff;font-family:sans-serif;font-size:16px;font-weight:bold;">
                          MyInspirent.com/Anne.Wilon
                        </center>
                      </v:roundrect>
                      <![endif]-->
  <![if !mso]>
  <table align="center" border="0" cellspacing="0" cellpadding="0">
    <tr>
      <td align="center" width="550" height="50" bgcolor="#292929" style="color: #ffffff; display: block;">
        <a href="#" style="font-size:16px; font-weight: 600; font-family:sans-serif; text-decoration: none; line-height:45px; width:550px; display:inline-block">
          <span style="color: #ffffff;">MyInspirent.com/Anne.Wilon</span>
        </a>
      </td>
    </tr>
  </table>
  <![endif]>
</div>

When previewing this in Outlook 2000-2003, <![if !mso]> and <![endif]> are showing up and the text inside the button isn't vertically centered. What can I do to fix this?

@NizzeB
Copy link

NizzeB commented Jun 22, 2016

Is it possible to also add an image inside the button? Much like this example here: http://media.mobileweb.bosscontrol.com/images/client/6143/buttons/search-button.png

@craigroh
Copy link

craigroh commented Dec 6, 2016

How would you go about centering this button?

@99niel
Copy link

99niel commented Jan 24, 2017

Once i click Button its turn to Yellow. I want it stay blue that is same as button color even when clicked.

@koez
Copy link

koez commented Jan 28, 2017

How to make the button inside email works? How to make it link to another php file within an email via click of the button. I'm using PHPMAILER for email. Thanks in advance

@fivedesigns
Copy link

fivedesigns commented Jul 5, 2017

how can i add text-decoration on <v:roundrect button text (underline)

Copy link

ghost commented Nov 17, 2017

Thank you for writing this code. I spent a lot of time yesterday looking for a button that looked nice and would work in Outlook. This is the first code I have found that works. Great Job!

David

@deniszavadskiy
Copy link

does this code work properly on windows 10 mail app?

@hayds
Copy link

hayds commented Jan 10, 2018

Thanks for this repo it's awesome. I wanted to have a button that changed width dynamically based on the text inside.

I found this https://litmus.com/community/discussions/538-vml-outlook-07-10-13-unwanted-20px-padding-at-the-bottom which shows how to use mso-fit-shape-to-text:true

And this https://litmus.com/community/discussions/1269-flexible-multi-line-bulletproof-buttons which shows how to avoid some unwanted padding.

This is my end result

<!--[if mso]>
  <v:roundrect xmlns:v="urn:schemas-microsoft-com:vml" xmlns:w="urn:schemas-microsoft-com:office:word" href="http://www.EXAMPLE.com/" style="mso-wrap-style:none; mso-position-horizontal: center" arcsize="10%" strokecolor="#0368d4" strokeweight="1px" fillcolor="#d62828">
	<v:textbox style="mso-fit-shape-to-text:true">
		<center style="color:#ffffff;font-family:sans-serif;font-size:16px;font-weight:bold;">Button Text Here!</center>
	</v:textbox>
  </v:roundrect>
  <![endif]-->
  <![if !mso]>
  <table cellspacing="0" cellpadding="0"> <tr> 
  <td align="center" width="300" height="40" bgcolor="#d62828" style="-webkit-border-radius: 5px; -moz-border-radius: 5px; border-radius: 5px; color: #ffffff; display: block;">
    <a href="http://www.EXAMPLE.com/" style="font-size:16px; font-weight: bold; font-family:sans-serif; text-decoration: none; line-height:40px; width:100%; display:inline-block">
    <span style="color: #ffffff;">
      Button Text Here!
    </span>
    </a>
  </td> 
  </tr> </table> 
  <![endif]>
</div>

Seems to work great in outlook 2016 which uses word to render HTML

@IamBigFool
Copy link

Hey i got an issue with the code, the roundrect was overlapping the text. Can anyone give me some guides, appreciate with thanks.

<!--[if mso]> <v:roundrect xmlns:v="urn:schemas-microsoft-com:vml" xmlns:w="urn:schemas-microsoft-com:office:word" style="height:36px;v-text-anchor:middle;width:350px;position:absolute; top:280; left:310;" arcsize="5%" strokecolor="#EB7035" fillcolor="#EB7035"> <w:anchorlock/> <center style="color:#ffffff;font-family: sans-serif; letter-spacing: 1px; font-size:16px;">My Text!</center> </v:roundrect> <![endif]-->

@charlie-s
Copy link

Everyone that asked how to center the button, just wrap it in a <center> tag. I tried to horizontally align the v:roundrect with the o:hralign="center" attribute (along with anything else that I could find or made sense) but nothing really works. Best to just center the outer tag and the text with simple <center> tags:

<center>
    <v:roundrect xmlns:v="urn:schemas-microsoft-com:vml" xmlns:w="urn:schemas-microsoft-com:office:word" href="https://www.example.com" style="height: 45px; v-text-anchor: middle; width: 300px;" arcsize="10%" stroke="f" fillcolor="#6699ff">
        <w:anchorlock/>
        <center style="color: #ffffff; font-family: sans-serif; font-size: 15px;">
            Text
        </center>
    </v:roundrect>
</center>

@jaxx1rr
Copy link

jaxx1rr commented Sep 9, 2019

what if I don't want stroke="f", why is there no documentation on the internet about this? microsoft devs should be tortured daily

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment