viewport

Recommendations

Ensure Readability on All Devices

Setting the viewport width to device-width and initial scale to 1 ensures your site is readable on all devices.

Avoid Large Fixed Widths

Using a large fixed width can lead to a poor user experience on small screens, as users may have to scroll horizontally to view content.

Related Meta Tags

application-name

name

Defines the name of the web application as it should be displayed when bookmarked or added to a mobile home screen.

<html lang="en">
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <meta name="application-name" content="MyApp">
</html>

Simple, concise, and clearly displays the application's purpose or brand.

charset

Defines the character encoding standard for the HTML document. Character encoding is essential for rendering text correctly in browsers.

<html lang="en">
  <meta charset="charset" content="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
</html>

Declares UTF-8 as the character encoding for the HTML document, supporting most characters and symbols in use today.

color-scheme

name

Instructs the browser on what color themes (light or dark mode) are supported and preferred for the content, ensuring visual consistency and accessibility.

<html lang="en">
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <meta name="color-scheme" content="light dark">
</html>

Indicates to the browser that the site smoothly supports both light and dark themes, offering flexibility to match the user’s preferred theme setting.

Controls how telephone numbers, email addresses, and physical addresses are detected and displayed by the browser. By default, many browsers can automatically detect this information and style or link it accordingly, which might not always align with the web developers’ intentions.

<html lang="en">
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <meta name="format-detection" content="telephone=no">
</html>

Prevents the browser from auto-detecting and linking phone numbers, allowing the site to control how and if phone numbers are clickable.

default-style

http-equiv

Specifies the name of the preferred stylesheet to use on a web page. This allows users or user agents to choose the default stylesheet amongst many provided.

<html lang="en">
  <meta charset="utf-8">
  <meta name="viewport" content="width=device-width, initial-scale=1">
  <meta http-equiv="default-style" content="Main Style">
</html>

Correct use case where "Main Style" is precisely the title of one of the page’s alternative stylesheets.

<zhead>

Code Examples