User-Agent String Format

Samsung Internet User-Agent String Format

Mozilla/$(MOZILA_VER) ($(DEVICE_TYPE); $(OS); $(PLATFORM) $(PLATFORM_VER);
SAMSUNG $(MODEL_NAME) Build/$(BUILD_TAG)) AppleWebKit/$(APPLEWEBKIT_VER)
(KHTML, like Gecko) $(APP_NAME)/$(APP_VER) (Chrome/$(CHROME_VER))
$(UX RECOMMEND) Safari/$(SAFARI_VER)

Field Description Required
$(DEVICE\_TYPE)

“SMART-TV” is used for Samsung Smart TV. Mobile devices do not use this field.

Optional
$(PLATFORM) $(PLATFORM\_VER)

“Tizen” is used for Samsung Smart TV 2015 new models (and later), and for Tizen Mobile. Mandatory
SAMSUNG

Company name Optional
$(MODEL\_NAME)

Mobile devices use MODEL\_NAME field for each device. Smart TV currently does not use this field. This Field will be possibly used in the future.

Optional
Build/$(BUILD\_TAG))

Platform Build Tag is used on Android devices. Currently, Tizen devices do not use this field. It may be possibly used in the future. Optional
$(APP\_NAME)/$(APP\_VER)

Web Browsers on Samsung devices (Mobile and Smart TV) use “SamsungBrowser/version”.

Mandatory
(Chrome/$(CHROME\_VER))

This field is presented in a Chrome-based web browser only. Android Browser is currently presented this way whereas, Tizen Samsung Browser is not as it is based on webkit. This will also reflect on the Tizen Samsung Browser if it will be based on Chrome in the future. Optional
$(UX\_RECOMMEND)

Mobile devices with small screens (e.g. less than 7") use “Mobile”. Smart TVs use “TV”. For devices supporting Virtual Reality contents, use “VR”. If PC UX is appropriate for the device, this field is empty.

Optional

Request for PC Content

Users can explicitly request PC content from Samsung Internet for Android via the "More > Desktop version".
User agent string format for desktop version request is as follows.

Mozilla/$(MOZILA\_VER) (X11; Linux x86\_64) AppleWebKit/$(APPLEWEBKIT\_VER) (KHTML, like Gecko) $(APP\_NAME)/$(APP\_VER) (Chrome/$(CHROME\_VER)) Safari/$(SAFARI\_VER)

Example:

Mozilla/5.0 (X11; Linux x86\_64) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/5.2 Chrome/51.0.2704.106 Safari/537.36

Samsung Web Application User-Agent String Format

Mozilla/$(MOZILA_VER) ($(DEVICE_TYPE); $(OS); $(PLATFORM) $(PLATFORM_VER);
SAMSUNG $(MODEL_NAME) Build/$(BUILD_TAG)) AppleWebKit/$(APPLEWEBKIT_VER)
(KHTML, like Gecko) Version/$(PLATFORM_VER) (Chrome/$(CHROME_VER))
$(UX RECOMMEND) Safari/$(SAFARI_VER)
Field Description Required
Version/$(PLATFORM\_VER)

Web Application using the platform’s webView, have Version/OS’s Version instead of $(APP\_NAME)/$((APP\_VER)

Mandatory

※ if the $(PLATFORM\_VER) is less than 4.0, than it is not a Web Application.

Other fields are same with Web browser.

Samsung Internet for Smart-TV User-Agent String Format

Please check below for existing Samsung Internet for SmartTV UA.

Identify the Samsung Internet for SmartTV by using the “SMART-TV” keyword.

Year UA String
2015 Mozilla/5.0 (SMART-TV; Linux; Tizen 2.3) AppleWebkit/538.1 (KHTML, like Gecko) SamsungBrowser/1.0 TV Safari/538.1

2014 Mozilla/5.0 (SMART-TV; X11; Linux armv7l) AppleWebkit/537.42 (KHTML, like Gecko) Safari/537.42

2013 Mozilla/5.0 (SMART-TV;X11; Linux i686) AppleWebkit/535.20+ (KHTML, like Gecko) Version/5.0 Safari/535.20+

2012 Mozilla/5.0 (SMART-TV; X11; Linux i686) AppleWebKit/534.7 (KHTML, like Gecko) Version/5.0 Safari/534.7

2015 Mozilla/5.0 (SmartHub; SMART-TV; U; Linux/SmartTV) AppleWebKit/531.2 (KHTML, like Gecko) Web Browser/1.0 SmartTV Safari/531.2+

User-Agent(UA) String Examples

Previous: UA String used in devices before 2015

Current: New UA String used in

  • Mobile : 2015 and later released devices, and Android 5.0 Lollipop updated devices (with the small number of exceptions)

  • TV : Tizen SmartTV Web Browser 2015 and later

Samsung Internet for Android

  • Previous (Samsung Galaxy Note Edge): Mozilla/5.0 (Linux; Android 4.4.4; en-au; SAMSUNG SM-N915G Build/KTU84P) AppleWebKit/537.36 (KTHML, like Gecko) Version/2.0 Chrome/34.0.1847.76 Mobile Safari/537.36

  • Current (Samsung Internet for Android 4.0): Mozilla/5.0 (Linux; Android 5.0.2; SAMSUNG SM-G925F Build/LRX22G) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/4.0 Chrome/44.0.2403.133 Mobile Safari/537.36

Samsung Internet for Tizen Mobile

  • Current: Mozilla/5.0 (Linux; Tizen 2.3; SAMSUNG SM-Z130H) AppleWebKit/537.3 (KHTML, like Gecko) SamsungBrowser/1.0 Mobile Safari/537.3

Tizen Mobile Web Application

  • Current: Mozilla/5.0 (Linux; Tizen 2.3; SAMSUNG SM-Z130H) AppleWebKit/537.3 (KHTML, like Gecko) Version/2.3 Mobile Safari/537.3

Samsung Internet for Smart-TV

  • Current: Mozilla/5.0 (SMART-TV; Linux; Tizen 2.3) AppleWebkit/538.1 (KHTML, like Gecko) SamsungBrowser/1.0 TV Safari/538.1

Tizen TV Web Application

  • Current: Mozilla/5.0 (SMART-TV; Linux; Tizen 2.2; SAMSUNG SM-Z910F) AppleWebKit/537.3 (KHTML, like Gecko) Version/2.2 TV Safari/538.1

Samsung Internet for Gear VR

  • Current: Mozilla/5.0 (Linux; Android 5.0.2; SAMSUNG SM-G925K Build/LRX22G) AppleWebKit/537.36 (KHTML, like Gecko) SamsungBrowser/4.0 Chrome/44.0.2403.133 Mobile VR Safari/537.36

Content Guide

  • Request for Mobile Content

    • If $(UX\_RECOMMEND) is “Mobile”, Mobile page and UX are appropriate

  • Request for TV Content

    • If $(DEVICE\_TYPE) is “SMART-TV” or $(UX\_RECOMMEND) is “TV”, it is proper for TV content. If the web page is not suitable for the TV Web Browser, provide the web page for Tablet or PC version (Tablet web page is preferred over the PC version). ※Consider the Resize Event※ On the Resize Event, focus should be maintained on the Input field so that the user of the TV web browser can input characters and symbols using Samsung IME.

    • Samsung Smart TV uses both fields: “SMART-TV” for $(DEVICE\_TYPE) and “TV” for $(UX\_RECOMMEND).

    • Do not use Flash content. Use HTML5 <VIDEO> for video, and JavaScript and CSS3 for animation and effects.

  • Request for PC Content

    • If $(UX\_RECOMMEND) is empty, PC content is shown
    • If there is no TV oriented content, PC content option is OK.

  • “Samsung” is not used for Mobile Only. “Samsung” is not a good identifier for Mobile.

  • “Tizen” is not used for Mobile Only. “Tizen” is also not a good identifier for Mobile.

  • $(PLATFORM): Android can be used for Mobile and Tablet (PC); Tizen can be used for Mobile and TV.

The following table shows how the identifiers and proper contents are related.

Proper Contents $(DEVICE_TYPE)

 $(PLATFORM)
Mobile ― Android or Tizen Mobile
TV SMART-TV Tizen TV
PC ― Android or Tizen ―

Test Guide

  • Samsung recommends the use of Chrome development tool or Chrome's user agent switcher extension to verify the contents on the Samsung web browser. Refer to Chrome developer site. Change to the example UA strings.
    http://developer.chrome.com/devtools/docs/device-mode#screen-emulator

  • Step 1. Open the test web page on the desktop Chrome Browser.

    Step 1. Open the test web page on the desktop Chrome Browser.

  • Step 2. Activate developer mode (Pressing F12) and activate device mode (Pressing Ctrl + Shift + M)

  • Step 3. Enter the Samsung UA string and screen resolution that you want to test.
    For Samsung Tizen smartphone SM-Z130H Kiran, screen resolution is 480X800 and UA string is
    “Mozilla/5.0 (Linux; Tizen 2.3; SAMSUNG SM-Z130H) AppleWebKit/537.3 (KHTML, like Gecko) SamsungBrowser/1.0 Mobile Safari/537.3"

    Step 3. Enter the Samsung UA string and screen resolution that you want to test.

  • For TV, Turn off the Flash option. Refer to screen below. The test guide is provided below:
    - Chrome Browser: Settings -> Content settings

    Step 3. Enter the Samsung UA string and screen resolution that you want to test.

    Step 3. Enter the Samsung UA string and screen resolution that you want to test.

  • If unable to test with Chrome Browser, a FireFox Browser with the add-on from the following link is another option.
    https://addons.mozilla.org/ko/firefox/addon/user-agent-switcher/?src=search
    Refer to developer site for the FireFox add-on: http://chrispederick.com/work/user-agent-switcher/
    Change to the example UA strings.