New Gatsby Plugin Image: One Of The Coolest Innovations At GatsbyConf 2021 by@braydoncoyer

New Gatsby Plugin Image: One Of The Coolest Innovations At GatsbyConf 2021

New Gatsby Plugin Image: One of the Coolest Innovations at Gatsbys 2021. New Gatby Image provides a new way to display images. Images can be displayed before the image is fully loaded. Images are now available in Gatbys' new version of the toolkit. The new version has been released on January 1, 2021. The Gatbsby plugin is available now on iOS and Android platforms with the latest version of version 3.2.0.
Braydon Coyer Hacker Noon profile picture

Braydon Coyer

Sr Full Stack Engineer, Front-End Specialist, DOM Artist.

2021 seems to be flying by quickly. March is off to a great start with the coming and going of GatsbyConf 2021 and the big announcement of Gatsby v3.0! There are many reasons to love Gatsby and v3.0 brings with it many new features and changes:

  • Incremental Builds
  • A revamped Gatsby Plugin Image
  • 70% improved local developer experiences
  • Faster refreshes
  • WordPress & Contentful updates
  • And updates to all of the major dependencies

Wow! There are many things to digest here, but perhaps the most exciting for me is the newly revamped Gatsby Plugin Image that shipped with Gatsby v3.0!

What is Gatsby Plugin Image?

Images are a key component to building beautiful user interfaces, but optimizing them in a performant manner can prove to be anything but easy. Performant user interfaces (specifically when it comes to images) require a lot of thought. After all, we don’t want to load large images to be displayed for mobile users and likewise, we don’t want to serve small images for larger devices. Luckily, Gatsby provides an official plugin that not only optimizes our images but also produces the images at multiple sizes so our app can choose the best size for the screen that’s viewing the webpage.

What’s new with Gatsby Plugin Image? StaticImage and GatsbyImage Components!

Before v3.0, Gatsby Image required you to make a query and pass the image source to a single generic

<Img />
component provided from the plugin. While not difficult to work with, the plugin required some tinkering to get working properly.

Rebuilt from the ground-up, Gatsby Plugin Image provides two new components for static and dynamic images, along with a few properties for how the image should be displayed before it fully loads.

For static images that will always be the same, the new

<StaticImage />
component should be utilized. Here's an example taken from official documentation.

import { StaticImage } from "gatsby-plugin-image"

export function Dino() { 
     return <StaticImage src="../images/dino.png" 
                 alt="A dinosaur" /> 

As applications become more complex, it’s not uncommon for images to be dynamically sourced. In situations like this, the revamped plugin provides a component called

<GatsbyImage />
. This component works very similarly to the old plugin. Here's an example.

import { graphql } from "gatsby"
import { GatsbyImage, getImage } from "gatsby-plugin-image"

function BlogPost({ data }) {
 const image = getImage(data.blogPost.avatar)
 return (
	 <GatsbyImage image={image} alt={} />

export const pageQuery = graphql`
 query {
   blogPost(id: { eq: $Id }) {
	 avatar {
	   childImageSharp {
		   width: 200
		   placeholder: BLURRED
		   formats: [AUTO, WEBP, AVIF]

Image Options

As you’d expect from an official plugin, the new Gatsby Plugin Image provides several options for customization. Options are passed to the

<StaticImage />
component as props, or through the GraphQL resolver for the
<GatsbyImage />

I’d like to focus on the

option, which determines how the image is displayed until fully loaded. According to the documentation,

To ensure that the layout does not jump around, a placeholder is displayed before the image loads.

You’ve probably seen this before (it’s very common on blog sites) — you load a page and see a temporary blurred block that eventually clears up and displays the crisp image.

The Gatsby Plugin Image provides three types of placeholders for the component:

  • Dominant Color — the default option which calculates the dominant color in the image and uses it as a background until the image is fully loaded.
  • Blurred — this option generates a blurred background until the image is fully loaded.
  • Traced SVG — the final option produces a simple sketched version of the final image and fills in the lines when the image is fully loaded.

For a full list of options and integration steps, refer to the official documentation.

Migration to the new Gatsby Plugin Image

Migrating to the new system is easy thanks to a codemod released by the Gatsby team. I updated my personal website to use the new Gatsby Plugin Image within 5 minutes thanks to the direct documentation!


The new Gatsby Plugin Image has been rebuilt from the ground-up and provides several new features and enhancements that make working the plugin much easier. If you’re coming from a past Gatsby project, it’s easy to migrate to the new system. If you’re new, the Gatsby team has done a wonderful job of producing easy-to-understand documentation.

Did you attend GatsbyConf this year? What was your favorite announcement?

Previously published at


Join Hacker Noon

Create your free account to unlock your custom reading experience.