Introduction
browserconfig.xml is an XML file that defines customisations of a pinned site: the images and colour of its tiles, and addresses polled for badge and
tile notifications. It is a Microsoft format for Internet Explorer 11: the page read for this site is the Internet Explorer developer documentation, “Browser configuration schema reference”, in the archived
previous-versions section, and it documents IE11 only (this site’s name and summary say “Edge legacy” as a hint at its later use, which the page does not document). Browser configuration files let a site set these
customisations in an external XML file rather than as meta elements in its pages.
Structure
<browserconfig>
<msapplication>
<tile>
<square70x70logo src="small.png"/>
<square150x150logo src="medium.png"/>
<wide310x150logo src="wide.png"/>
<square310x310logo src="large.png"/>
<TileColor>#009900</TileColor>
</tile>
<badge>
<polling-uri src="badge.xml"/>
<frequency>30</frequency>
</badge>
</msapplication>
</browserconfig>
| Element | Rule (Microsoft schema reference) |
|---|---|
browserconfig | The root element; required; supports no attributes. |
msapplication | A vendor-specific element for the type of application (pinned sites); required, as a child of browserconfig; supports no attributes. |
tile | Optional. Defines the images and colour of the tiles. |
square70x70logo, square150x150logo, wide310x150logo, square310x310logo | The src attribute names the image for the small, medium, wide and large tile. |
TileImage | The src of the medium tile; square150x150logo is preferred. |
TileColor | The colour of the tile, such as #009900. |
badge | Optional. A polling-uri whose src is an XML file with badge markup, polled repeatedly, and a frequency. |
notification | Optional. Up to five URIs to poll for tile markup: polling-uri, polling-uri2 to polling-uri5; a frequency; a cycle. |
frequency | Minutes between poll requests: 30, 60, 360, 720 or 1440. |
cycle | 0 (default with one notification): no tiles show notifications; 1 (default with several): cycle for all tile sizes; 2: medium only; 3: wide only; 4: large only; 5: medium and wide; 6: medium and large; 7: large and wide. |
Element names are case sensitive and must be written as shown. A page names the file with <meta name="msapplication-config" content="IEconfig.xml" />;
with content="none" a page turns it off. If a page names none, IE11 looks for browserconfig.xml in the root directory of the server. Relative references are taken to be in the same
directory as the file; absolute paths are recommended.
In the explorer
A file named browserconfig.xml, or any .xml file whose root element is browserconfig with no namespace, opens here: the XML tree, tabs for the tile,
badge and notification elements, and the problems. A problem is any rule above that is broken, an element the schema reference does not list under its parent, or a name
written in the wrong case. Any other file called browserconfig.xml (an HTML error page, other XML) opens as XML or plain text as before. Nothing is fetched.
Not described
Known, not yet covered
- Reference: the tile, toast and badge notification markup that the polled files hold is in a separate Microsoft schema reference and is not described here.
- Viewer: image files and polling addresses are not fetched; a colour is checked for shape only (the page gives one example).
Unknown
- Reference: elements that other tools write into the file (for example a
TileImagewith other attributes) beyond the schema reference are labelled as not in the reference and nothing more; no other source was read. - Reference: which current browsers still read the file: the Microsoft page documents Internet Explorer 11 only.
Links
Reference
- Browser configuration schema reference – Microsoft’s documentation of the elements (archived)