Export (0) Print
Expand All

Configure the browser definition file in SharePoint 2013

SharePoint 2013
 

Applies to: SharePoint Server 2013, SharePoint Foundation 2013

Topic Last Modified: 2013-12-18

Summary: Learn how to modify the browser definition file in SharePoint 2013 to change the redirect behavior of a mobile browser, or add or delete mobile device entries.

A mobile view is a version of the SharePoint site that has been optimized for mobile devices. The browser definition file lists the mobile browsers and devices that are supported by SharePoint Server 2013 and is used to redirect mobile browsers to the mobile views. You can modify the browser definition file to change the redirect behavior of a mobile browser, or to add or delete entries from the list of supported mobile devices.

The browser definition file lists the mobile browsers and devices that can access mobile views in SharePoint Server 2013. When a user browses a SharePoint site from a mobile device, the mobile browser submits to the site an HTTP GET request that includes a user agent string. If the mobile browser and device model in the user agent string are listed in the browser definition file and the isMobileDevice setting for the mobile browser is set to true, SharePoint Server 2013 redirects the mobile browser to the mobile view of the site. Otherwise, a standard view of the site is shown in the mobile browser. You can modify the file to change the redirect behavior of a mobile browser.

The browser definition file lists the mobile browsers and devices that are supported by SharePoint Server 2013. The file can be updated when product updates to SharePoint Server 2013 are released. You can also modify the file to add a mobile browser or device to the list.

NoteNote:
There is a compat.browser file for each Internet Information Services (IIS) website. If you change the compat.browser file on a SharePoint Web front-end (WFE) server you must also do so on every WFE in the farm.
To change the redirect behavior of a mobile browser
  1. Click Start, click Administrative Tools, and then Internet Information Services (IIS) Manager.

  2. Right-click the IIS website where the SharePoint web application is installed, and then click Explore.

  3. In Windows Explorer, double-click the App_Browsers folder.

  4. Open the compat.browser file in a text editor.

  5. Find the <browser> node that corresponds to the mobile browser or device that you want to modify.

  6. Find the <capability name="isMobileDevice" value="true" /> element.

  7. Set the value attribute to false to display a standard view of the site in the mobile browser.

  8. Save your changes to the compat.browser file.

  9. Restart IIS by entering the following command at the command prompt: iisreset /noforce.

To add a mobile browser or device, you create a <browser> node that identifies the mobile browser or device and defines its capabilities. For more information about what can be entered in the <browser> node, see Browser Definition File Schema (browsers Element) in the MSDN Library.

To add a mobile browser and device model
  1. Click Start, click Administrative Tools, and then click Internet Information Services (IIS) Manager.

  2. Right-click the IIS website where the SharePoint web application is installed, and then click Explore.

  3. In Windows Explorer, double-click the App_Browsers folder.

  4. Open the compat.browser file in a text editor.

  5. Find the <browsers> node.

  6. Add a new <browser> node to the end of the list of browsers.

  7. Save your changes to the compat.browser file.

  8. Restart IIS by entering the following command at the command prompt: iisreset /noforce.

Was this page helpful?
(1500 characters remaining)
Thank you for your feedback
Show:
© 2014 Microsoft