These are the docs for v2, which has an open maintenance window until April 1, 2021. View the v3 docs.

  • Gatsbyjs.com
    Gatsbyjs.com
  • Gatsby Cloud
    Gatsby Cloud
  • Support
    Support
  • Contact
    Contact
  • Log in
    Log in
docs
    • Tutorial
      Tutorial
    • How-to Guides
      How-to Guides
    • Reference
      Reference
    • Conceptual Guide
      Conceptual Guide
    • Quick Start
      Quick Start
    • v2

      • v3

        v3

      • v2

        v2

      • v1

        v1

DocumentationHow-to Guides
Docs

Adding Images and Media

Images and media are a key part of making websites rich and interactive. Gatsby offers tools to create rich experiences with gatsby-image, while preventing performance hits.

 Main Guides 4

How to load an image from the filesystem→

There are two major ways to import assets, such as images, fonts, and files, into a Gatsby site.

How to use Gatsby Image→

Part of what makes Gatsby sites so fast is its recommended approach to handling images. `gatsby-image` is a React component designed to work seamlessly with Gatsby’s native image processing.

How to load a video→

The easiest method for including video on a Gatsby site is to source an uploaded file from a site like YouTube, Vimeo, or Twitch.

How to load a GIF→

When working with animated GIFs, you'll want to import them directly instead of using gatsby-image.

 Additional Guides 4

  • Using the Static Folder
  • Working with other media types
  • Using Gatsby Image with Remote Images
  • Using Cloudinary for image transforms
  • Accessibility Statement
  • Code of Conduct
  • Logo & Assets
  • Privacy Policy
  Docs
  • How-to Guides
    • Overview
    • Overview
    • How to load an image from the filesystem
    • How to use Gatsby Image
    • How to load a video
    • How to load a GIF
    • Additional Guides 4