Treehouse: Grow your CSS skills. Land your dream job.

Last updated on:

Responsive Meta Tag

I tend to use this:

<meta name="viewport" content="width=device-width">

Although I see this is recommended a lot:

<meta name="viewport" content="width=device-width, initial-scale=1">

This means that the browser will (probably) render the width of the page at the width of its own screen. So if that screen is 320px wide, the browser window will be 320px wide, rather than way zoomed out and showing 960px (or whatever that device does by default, in lieu of a responsive meta tag).

Note: don't use a responsive meta tag if your website isn't specifically designed to be responsive and work well at that size, as it will make the experience worse.

There are more attributes this tag supports:

Property Description
width The width of the virtual viewport of the device.
device-width The physical width of the device's screen.
height The height of the "virtual viewport" of the device.
device-height The physical height of the device's screen.
initial-scale The initial zoom when visiting the page. 1.0 does not zoom.
minimum-scale The minimum amount the visitor can zoom on the page. 1.0 does not zoom.
maximum-scale The maximum amount the visitor can zoom on the page. 1.0 does not zoom.
user-scalable Allows the device to zoom in and out. Values are yes or no.

It's generally recommended that you don't prevent scaling, as that's annoying and potentially an accessibility problem.

You'll probably want this in your CSS as well:

  width: device-width;

Good to know: changing the value of this meta tag with JavaScript does work, the page will react to the new value. Either out the entire tag and replace, or change the content property. Not a super common need, but it can come up.


  1. Alison
    Permalink to comment#

    Thanks works great on my IPad but not on my Ipone

    • Pali Madra
      Permalink to comment#

      Seems like it does not work perfectly for everyone. I tried it and it works fine with the phones but problems are there on samsung tablet.

  2. spellright
    Permalink to comment#

    it’s spelled “iPad” and “iPhone”.

  3. Lakeside Techies
    Permalink to comment#

    Even google has taken responsive sites as default and will rank those sides higher and better. So every measure has to be taken so that your site is viewed better in all devices.

  4. Monica
    Permalink to comment#

    meta name viewport doesn’t work correctly

    i tried all these meta tags on my website but no one of them worked
    meta name=”viewport” width=”device-width”
    meta name=”viewport” content=”width=device-width, initial-scale=1.0″
    meta name=”viewport” content=”width=device-width, initial-scale=1, maximum-scale=1″
    meta name=”viewport” content=”width=device-width, initial-scale=1, maximum-scale=1, user-scalable=no”

    but when i added @-ms-viewport{ width: device-width; } to style.css it worked but the width is not 100% on my iphone and samsung tab, users still need to scroll horizentally.
    My main content width is 1070px.

    • blaqstar
      Permalink to comment#

      you will have to add some codes in the style sheet for the different screen sizes there are. so that the page will adjust itself if the user is on a tablet or a phone i.e. “viewport”
      this is what i do.

      @media screen and (max-width: 768px){
      and then styles go in here}

      where “768px” is the the screen size. i’ll do the same thing for a mobile screen size that will be about 320px.

      @media screen and (max-width: 320px){

  5. robert
    Permalink to comment#

    It’s because, depending on the device, scale=1 is not scale=1 but scale=1.5…

    So yeah, here’s html5 awesomeness.
    Me too, I wonder how many geniuses are required to end up with such a stupid result.
    You specify scale 1, you get 1.5

    It has to do with dpi/definition of the device, basically 1 pixel is not equal to 1 pixel.

    Good luck with that.

  6. Sanjeev
    Permalink to comment#

    **Hey I am confused and I want one help from you.
    I need to insert viewport metatag into only index page or all the pages.
    Please reply, Eagerly waiting for your response ?

  7. Laura
    Permalink to comment#

    My website is not scaling down for ipad mini, is there a way I can change the scale so that the mini sees the mobile version of my website?

    Contains this in the header:
    <meta name=”viewport” content=”width=device-width,initial-scale=1″>

    And this in the css:
    #featured-content .flex-viewport {
    max-height: 2000px;
    -webkit-transition: all 1s ease;
    -moz-transition: all 1s ease;
    transition: all 1s ease;
    #featured-content .loading .flex-viewport { max-height: 300px; }

    Thank you for your help!!


  8. Maks
    Permalink to comment#

    There is a bug with viewport units on iOS7 and lower. To fix it just you this js:

  9. it a trimendious site for asker
    Permalink to comment#

    I want to view my web page zoom in and out in all mobile and when open in internet it minimize look scrol look how can i do

  10. DAAN
    Permalink to comment#

    I have a question.

    Im creating a simple jquerry fitnesswebsite, and I am trying to create a startscreen with the picture of the human body. On that picture I’ve placed some shapes with links so when you click on the arms you go to a the page where you can find ways to train your arms and so on.

    But the problem is, when the device changes, the picture has to change with it. Which is no problem. But the coordinates have to change with it. Onfortunately that wont work for my.
    I’ve tried to create a formula to with the variable device-width in it:


    195 is the Original width of the device and 20 ,118,95 and 246 are the coordinates on the Original picture. But it wont work for me. Is there a way to make this posible?

  11. Gabriel
    Permalink to comment#

    Try to put the width as “100%” , and then the layout will adjust in any screen

  12. Saitove
    Permalink to comment#

    I got some issues with iPad and the thing i did to fix it was adding content=”width=number .. sometimes it could be a better choise adding various width number rather “device-width” for web site fitting in the screen. Check it if you want its my first site ever :D

  13. Juan
    Permalink to comment#

    Quick question! What will be the difference between
    name=”viewport” content=”initial-scale=1, maximum-scale=1, user-scalable=0″
    name=”viewport” content=”width=device-width, initial-scale=1.0″


  14. satriyoz
    Permalink to comment#

    thanks, this is really helpful..
    i was wonder how to make my website automatically zoomed in when user open via smartphone.

  15. Viggo Danielsen
    Permalink to comment#

    Maybe these two is the solution (put both in CSS somewhere at the top):

    @viewport{ zoom: 1.0; width: extend-to-zoom; }
    @-ms-viewport{ width: extend-to-zoom; zoom: 1.0; }

  16. Elad Karako
    Permalink to comment#

    1]   you either should specify @viewport or use meta-tag <meta name="viewport" ...,

    you should not use both, the meta-tag is translated by the rendering engine to the @viewport rule, overriding whatever you’ll be writing in there…

    >> viewport on

    2]   the viewport meta-tag can be omitted completely, and be replaced with sending the data in the page’s headers instead,
    this can can help you save quite a lot of precious page space, making your pages smaller (and more readable..)
    actually you can do it for all the meta-tag in your page (including the newer ones of apple-tags and og:* ones..)

    here is a working example (PHP)

    header('Charset: UTF-8', true);
    header('Content-Encoding: UTF-8', true);
    header('Content-Type: text/html; charset=UTF-8', true);
    header('apple-mobile-web-app-capable: yes', true); //mobile friendly hacks
    header('apple-mobile-web-app-status-bar-style: translucent black', true); //run in full-screen mode
    header('viewport: width=device-width, height=device-height, initial-scale=1.0, maximum-scale=1.0, minimum-scale=1.0, user-scalable=no, user-scalable=0', true);
    ?><!DOCTYPE html><html>.......

    read more..

  17. Gerhard
    Permalink to comment#

    Is there an alternative to “device-width”? The reason I’m asking is because I want this bootstrap site to respond to the container size and not the window. The page is split in 2 and when I re-size the splitter I want the “columns” to respond and currently it will only respond when I re-size the actual browser window.. :/

  18. Etern
    Permalink to comment#

    Guys i just new to website coding, i facing some problem during beginning of coding, if you guys can help me out for this , i much appreciate:)





    font-family: ‘Open Sans’, sans-serif;

    margin:5 20;

    About us
    Contact us

    This is my coding, my problem stuck on the “header div” & “headWrapper div” part, when i wan to put margin-top on “headWrapper div”, both div of “header” & “headWrapper” will goes down together, i wish to just only the inner part div have margin-top.

Leave a Comment

Posting Code

We highly encourage you to post problematic HTML/CSS/JavaScript over on CodePen and include the link in your post. It's much easier to see, understand, and help with when you do that.

Markdown is supported, so you can write inline code like `<div>this</div>` or multiline blocks of code in in triple backtick fences like this:

  function example() {
    element.innerHTML = "<div>code</div>";