What does do?

This answer was posted several years ago and now the question really should be should you even consider using the X-UA-Compatible tag on your site? with the changes Microsoft has made to its browsers (more on those below).

Depending upon what Microsoft browsers you support you may not need to continue using the X-UA-Compatible tag. If you need to support IE9 or IE8, then I would recommend using the tag. If you only support the latest browsers (IE11 and/or Edge) then I would consider dropping this tag altogether. If you use Twitter Bootstrap and need to eliminate validation warnings, this tag must appear in its specified order. Additional info below:

The X-UA-Compatible meta tag allows web authors to choose what version of Internet Explorer the page should be rendered as. IE11 has made changes to these modes; see the IE11 note below. Microsoft Edge, the browser that replaced IE11, only honors the X-UA-Compatible meta tag in certain circumstances. See the Microsoft Edge note below.

According to Microsoft, when using the X-UA-Compatible tag, it should be as high as possible in your document head:

If you are using the X-UA-Compatible META tag you want to place it as close to the top of the page’s HEAD as possible. Internet Explorer begins interpreting markup using the latest version. When Internet Explorer encounters the X-UA-Compatible META tag it starts over using the designated version’s engine. This is a performance hit because the browser must stop and restart analyzing the content.

Here are your options:

  • “IE=edge”
  • “IE=11”
  • “IE=EmulateIE11”
  • “IE=10”
  • “IE=EmulateIE10”
  • “IE=9”
  • “IE=EmulateIE9
  • “IE=8”
  • “IE=EmulateIE8”
  • “IE=7”
  • “IE=EmulateIE7”
  • “IE=5”

To attempt to understand what each means, here are definitions provided by Microsoft:

Internet Explorer supports a number of document compatibility modes that enable different features and can affect the way content is displayed:

  • Edge mode tells Internet Explorer to display content in the highest mode available. With Internet Explorer 9, this is equivalent to IE9 mode. If a future release of Internet Explorer supported a higher compatibility mode, pages set to edge mode would appear in the highest mode supported by that version. Those same pages would still appear in IE9 mode when viewed with Internet Explorer 9. Internet Explorer supports a number of document compatibility modes that enable different features and can affect the way content is displayed:
  • IE11 mode provides the highest support available for established and emerging industry standards, including the HTML5, CSS3 and others.
  • IE10 mode provides the highest support available for established and emerging industry standards, including the HTML5, CSS3 and others.
  • IE9 mode provides the highest support available for established and emerging industry standards, including the HTML5 (Working Draft), W3C Cascading Style Sheets Level 3 Specification (Working Draft), Scalable Vector Graphics (SVG) 1.0 Specification, and others. [Editor Note: IE 9 does not support CSS3 animations].
  • IE8 mode supports many established standards, including the W3C Cascading Style Sheets Level 2.1 Specification and the W3C Selectors API; it also provides limited support for the W3C Cascading Style Sheets Level 3 Specification (Working Draft) and other emerging standards.
  • IE7 mode renders content as if it were displayed in standards mode by Internet Explorer 7, whether or not the page contains a directive.
  • Emulate IE9 mode tells Internet Explorer to use the directive to determine how to render content. Standards mode directives are displayed in IE9 mode and quirks mode directives are displayed in IE5 mode. Unlike IE9 mode, Emulate IE9 mode respects the directive.
  • Emulate IE8 mode tells Internet Explorer to use the directive to determine how to render content. Standards mode directives are displayed in IE8 mode and quirks mode directives are displayed in IE5 mode. Unlike IE8 mode, Emulate IE8 mode respects the directive.
  • Emulate IE7 mode tells Internet Explorer to use the directive to determine how to render content. Standards mode directives are displayed in Internet Explorer 7 standards mode and quirks mode directives are displayed in IE5 mode. Unlike IE7 mode, Emulate IE7 mode respects the directive. For many web sites, this is the preferred compatibility mode.
  • IE5 mode renders content as if it were displayed in quirks mode by Internet Explorer 7, which is very similar to the way content was displayed in Microsoft Internet Explorer 5.

IE10 NOTE: As of IE10, quirks mode behaves differently than it did in earlier versions of the browser. In IE9 and earlier versions, quirks mode restricted the webpage to the features supported by IE5.5. In IE10, quirks mode conforms to the differences specified in the HTML5 specification.

Personally, I always choose the http-equiv="X-UA-Compatible" content="IE=edge" meta tag, as older versions have plenty of bugs, and I do not want IE to decide to go into “Compatibility mode” and show my site as IE7 vs IE8 or 9. I always prefer the latest version of IE.

IE11

From Microsoft:

Starting with IE11, edge mode is the preferred document mode; it represents the highest support for modern standards available to the browser.

Use the HTML5 document type declaration to enable edge mode:

<!doctype html>

Edge mode was introduced in Internet Explorer 8 and has been available in each subsequent release. Note that the features supported by edge mode are limited to those supported by the specific version of the browser rendering the content.

Starting with IE11, document modes are deprecated and should no longer be used, except on a temporary basis. Make sure to update sites that rely on legacy features and document modes to reflect modern standards.

If you must target a specific document mode so that your site functions while you rework it to support modern standards and features, be aware that you’re using a transitional feature, one that may not be available in future versions.

If you currently use the x-ua-compatible header to target a legacy document mode, it’s possible your site won’t reflect the best experience available with IE11.

Microsoft Edge (Replacement for Internet Explorer that comes bundled with Windows 10)

Information on X-UA-Compatible meta tag for the “Edge” version of IE. From Microsoft:

Introducing the “living” Edge document mode

As we announced in August 2013, we are deprecating document modes as of IE11. With our latest platform updates, the need for legacy document modes is primarily limited to Enterprise legacy web apps. With new architectural changes, these legacy document modes will be isolated from changes in the “living” Edge mode, which will help to guarantee a much higher level of compatibility for customers who depend on those modes and help us move even faster on improvements in Edge. IE will still honor document modes served by intranet sites, sites on the Compatibility View list, and when used with Enterprise Mode only.

Public Internet sites will be rendered with the new Edge mode platform (ignoring X-UA-Compatible). It is our goal that Edge is the “living” document mode from here out and no further document modes will be introduced going forward.

With the changes in Microsoft Edge to no longer support document modes in most cases, Microsoft has a tool to scan your site to check and see if it has code that is not compatible with Edge.

Chrome=1 Info for IE

There is also chrome=1 that you can use or use together with one of the above options like: <meta http-equiv="X-UA-Compatible" content="IE=Edge,chrome=1">. chrome=1 is for Google’s Chrome Frame which is defined as:

Google Chrome Frame is an open source browser plug-in. Users who have the plug-in installed have access to Google Chrome’s open web technologies and speedy JavaScript engine when they open pages in the browser.

Google Chrome Frame seamlessly enhances your browsing experience in Internet Explorer. It displays Google Chrome Frame enabled sites using Google Chrome’s rendering technology, giving you access to the latest HTML5 features as well as Google Chrome’s performance and security features without in any way interrupting your usual browser usage.

When Google Chrome Frame is installed, the web just gets better without you having to think about it.

But for that plug-in to work you must use chrome=1 in the X-UA-Compatible meta tag.

More info on Chrome Frame can be found here.

Note: Google Chrome Frame only works for IE6 through IE9, and was retired on February 25, 2014. More info can be found here. Thanks to @mck for the link.

Validation:

HTML5:

The page will validate using the W3 Validator only when using <meta http-equiv="X-UA-Compatible" content="IE=Edge">. For other values it will throw the error: A meta element with an http-equiv attribute whose value is X-UA-Compatible must have a content attribute with the value IE=edge. In other words, if you have IE=edge,chrome=1 it will not validate. I ignore this error completely as modern browsers simply ignore this line of code.

If you must have completely valid code then consider doing this on the server level by setting HTTP header. As a note, Microsoft says, If both of these instructions are sent (meta and HTTP), the developer's preference (meta element) takes precedence over the web server setting (HTTP header). See olibre’s answer or bitinn’s answer for more details on how to set an HTTP header.

XHTML

There isn’t an issue with validation when using <meta http-equiv="X-UA-Compatible" content="IE=Edge" /> as long as the tag is properly closed (i.e. /> vs >).

Twitter Bootstrap

This tag has been strongly recommended by the Bootstrap team since at least 2014, and Bootlint, the linter authored by the twbs team continues to throw a warning when the tag is omitted. The linter distinguishes between warnings and errors, and as such the severity of omitting this tag may be considered minor.

For more information on X-UA-Compatible see Microsoft’s Website Defining Document Compatibility.

For more information on what IE supports see caniuse.com.

For more information on Twitter Bootstrap requirements, see the bootlint project wiki page.

Related Posts:

  1. What does do?
  2. Is it still valid to use IE=edge,chrome=1?
  3. Hide scroll bar, but while still being able to scroll
  4. My website doesn’t work in I.E. (but does in chrome and firefox)
  5. Onclick javascript to make browser go back to previous page?
  6. How to check View Source in Mobile Browsers (Both Android && Feature Phone)
  7. What is gZip compression?
  8. How to access and download a file from a server using HTML 5
  9. Open source social media icons to download and use on website? [closed]
  10. CSS calc width and height values
  11. HTML encoding issues – “” character showing up instead of ” “
  12. Center image using text-align center?
  13. CSS Background Opacity [duplicate]
  14. How to create an HTML button that acts like a link
  15. What does In html mean
  16. Center image horizontally within a div
  17. Remove CSS class from element with JavaScript (no jQuery) [duplicate]
  18. Center-align a HTML table
  19. Is there any way to change input type=”date” format?
  20. How to center a “position: absolute” element
  21. How to run python script in HTML?
  22. Set the table column width constant regardless of the amount of text in its cells?
  23. CSS Display an Image Resized and Cropped
  24. How do I make a placeholder for a ‘select’ box?
  25. Javascript: getElementById vs getElementsById (both works on different pages)
  26. localhost/test.php returns nothing
  27. CSS color vs. background-color vs. background?
  28. Getting “Failed to load resource: net::ERR_FILE_NOT_FOUND” when trying to load a background image
  29. CSS: background-color only inside the margin
  30. Stretch background image css?
  31. Set cellpadding and cellspacing in CSS?
  32. WebForms UnobtrusiveValidationMode requires a ScriptResourceMapping for ‘jquery’. Please add a ScriptResourceMapping named jquery(case-sensitive)
  33. Disable Scrolling on Body
  34. CSS Background Image Not Displaying
  35. Changing image sizes proportionally using CSS
  36. How to give the background-image path in CSS?
  37. How to overlay image with color in CSS?
  38. CSS Background image not loading
  39. Outline radius?
  40. How to call a JavaScript function within an HTML body
  41. right align an image using CSS HTML
  42. CSS Background Image Not Displaying
  43. Show/hide ‘div’ using JavaScript
  44. Why is this HTML5 document invalid?
  45. Open an .html file with default browser using Bash on Mac
  46. html not linking css
  47. Removing border from table cells
  48. Check a radio button with javascript
  49. How do you give iframe 100% height
  50. HTML Display Current date
  51. Error: The requested URL “[no URL]”, is invalid
  52. How to get CSS to select ID that begins with a string (not in Javascript)?
  53. Hidden property of a button in HTML
  54. Setting table row height
  55. How do I disable the resizable property of a textarea?
  56. Is there any reason for using WebGL instead of 2D Canvas for 2D games/apps?
  57. Is it possible to set the equivalent of a src attribute of an img tag in CSS?
  58. Why is colspan not applied as expected
  59. Document Root PHP
  60. How to display a gif fullscreen for a webpage background?
  61. Padding a table row
  62. How to align 3 divs (left/center/right) inside another div?
  63. Align an element to bottom with flexbox
  64. How can I change the thickness of my
    tag
  65. jquery – how to show a hidden div
  66. How to create spoiler text?
  67. How do I horizontally center a table in Bootstrap
  68. How do I center text in a span?
  69. text-align justify not working
  70. Best way to center a
  71. Find out whether radio button is checked with JQuery?
  72. Display text on MouseOver for image in html
  73. How to make a div 100% height of the browser window
  74. How to resize an image to fit in the browser window?
  75. HTML / CSS table with GRIDLINES
  76. How to embed a Google Drive folder in a website
  77. Pure HTML Back Button
  78. Display text on MouseOver for image in html
  79. Layout a flex box similar to a table?
  80. html : iframe not showing content in html
  81. How can I capture the right-click event in JavaScript?
  82. In which directory do I find the HTML file of my wordpress pages?
  83. How can I publish Word files to a WordPress blog without losing the footnotes?
  84. Preserve white-space in Page
  85. How do we remove mystical [X] from text? Image included
  86. Remove html markup by wordpress
  87. How can I set different html lang attribute for different countries?
  88. Add Attribute to p Tag of Post Content
  89. custom html in page change in browser
  90. Add Adsense to a website but the server responds with error 510 [closed]
  91. Can’t save any WordPress post with the html tag in it
  92. remove string: ‘custom content…’ from every page
  93. How to disable escaping html chars in wordpress?
  94. Whitespace Before Doctype
  95. html entities occur in the_excerpt used as meta description
  96. Allow Access To Subfolder Of HTML For Logged In Visitors
  97. Removing Line Break Tags from a Page
  98. Insert data through a script directly in the db
  99. Using Tags Instead of Categories for site structure
  100. Use Mail-Tag from Contac Form 7 in a script

Leave a Comment

tech