Skip to content

WordPress Hero

If we have a full screen height hero image we need to take into account the menu header and also the admin bar when logged in. Using the mobile chin code we can use a custom property to set the height.

A full screen desktop image would need dimensions 2560 x 1440 (27-inch iMac), but can be slightly less height due to browser chrome and the website header. Let's say 2560 x 1400 px.

Based on and the portrait image gets shown on screens sizes up to 800 pixels wide. The height to width ratio for mobile devices is commonly between 1.78 and 2.16 (iPhones), while tablets can be as low as 1.3 (e.g. iPad Mini 768 x 1024 px). The 828px width breakpoint (used by Next.js) coincides with the iPhone 11 which has a device resolution of 828 x 1792. Therefore the size is recommended to be a minumum of 828 x 1600 px (taking into account there will normally be some header chrome and we round to an even number). This means the image will be big enough to be double density on the most common mobile devices, while the size of the image does not need to be ridiculously big (especially in terms of height).

When using <picture> it is best to wrap this in a <div> rather than using it is a top level grid cell as this can cause problems with height.

<div class="hero">
    $hero = get_field('hero_image');
    $width = $hero['sizes'][ 'full_2560-width' ];
    $height = $hero['sizes'][ 'full_2560-height' ];

    $hero_mobile = get_field('hero_image_mobile');
    $mobile_width = $hero_mobile['sizes'][ 'full_828-width' ];
    $mobile_height = $hero_mobile['sizes'][ 'full_828-height' ];

  <div class="col-start-1 row-start-1">

      <!-- Portrait -->
        media="(max-width: 828px)"
          <?php echo $hero_mobile['sizes']['full_640']; ?> 640w,
          <?php echo $hero_mobile['sizes']['full_750']; ?> 750w,
          <?php echo $hero_mobile['sizes']['full_828']; ?> 828w
        width="<?php echo $mobile_width; ?>"
        height="<?php echo $mobile_height; ?>"

      <!-- Landscape -->
        src="<?php echo $hero['sizes']['full_2560']; ?>"
          <?php echo $hero['sizes']['full_640']; ?> 640w,
          <?php echo $hero['sizes']['full_750']; ?> 750w,
          <?php echo $hero['sizes']['full_828']; ?> 828w,
          <?php echo $hero['sizes']['full_1080']; ?> 1080w,
          <?php echo $hero['sizes']['full_1200']; ?> 1200w,
          <?php echo $hero['sizes']['full_1440']; ?> 1440w,
          <?php echo $hero['sizes']['full_1920']; ?> 1920w,
          <?php echo $hero['sizes']['full_2048']; ?> 2048w,
          <?php echo $hero['sizes']['full_2560']; ?> 2560w
        alt="<?php echo $hero['alt']; ?>"
        class="object-cover w-full h-full"
        width="<?php echo $width; ?>"
        height="<?php echo $height; ?>"



  /* Align bottom left */
  <div class="flex flex-col justify-end col-start-1 row-start-1 p-7">
    <h1 class="text-white heading1">
      <?php the_field('page_heading'); ?>


The height of the hero is calculated, taking into account the admin bar when appicable.

.hero {
  @apply grid grid-cols-1 grid-rows-1;
  --hero-height: calc( 100svh - var(--header-height) );
  height: calc( var(--hero-height) - var(--wp-admin--admin-bar--height, 0px) );
  min-height: 420px;

Note: min-height is needed for unusual screens that are wide but not heigh. Ideally the following would work but the background image appears to extend the height beyond 100vh.

min-height: calc(var(--hero-height) - var(--wp-admin--admin-bar--height, 0px));
height: auto;


Use fetchpriority=”high” to load the LCP hero image sooner.

This is currently available on Chrome and Edge. Not on Safari or Firefox. It is suggested that fetchpriority be used rather than <link rel=preload>.