Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub

Gatsby Source Imgur Albums Plugin

This Gatsby plugin allows to “source” Imgur albums into what Gatsby calls nodes.

Inspired by gatsby-imgur-gallery-albums which was unfortunately not updated in the last years.

Dependencies (optional)

This plugin was tested using the gatsby-plugin-image plugin.

How to install

npm add gatsby-source-imgur-albums

When do I use this plugin?

This plugin is useful if you want to add images from Imgur albums to your Gatsby site.

Examples of usage

The plugin is used in production at my portfolio website (source code).

Add the plugin into your site’s gatsby-config.js file:

module.exports = {
  plugins: [
      resolve: `gatsby-source-imgur-albums`,
      options: {
        clientId: "XXXXXX", // register a new app at https://api.imgur.com/oauth2/addclient and select "Anonymous usage without user authorization"
        albumHashes: ['abc', 'def'], // checkout https://dev.to/codingcoach/get-your-album-id-in-imgur-b6c to get the ID of your album
        debug: false, // if true, some debug messages are logged
        apiUrl: "https://...." // if not set, https://api.imgur.com/3/album/ is used per default

How to query for data

    imgurAlbums: allImgurAlbum {
      nodes {
        images {
          localFile {
            childImageSharp {
              gatsbyImageData(width: 200)
© 2023 Gatsby, Inc.