Migrate to Netlify Today

Netlify announces the next evolution of Gatsby Cloud. Learn more

ContactSign Up
Community Plugin
View plugin on GitHub

Gatsby Theme YouTube - Installation Guide & More

The theme was built to allow users to bring YouTube content to their Gatsby websites. The main package in this theme is gatsby-source-youtube-v2. Here is a working demo of the theme.


  1. Install theme via npm or yarn
npm install --save gatsby-theme-jam-youtube


yarn add gatsby-theme-youtube
  1. Add the theme to your gatsby-config.js:
module.exports = {
  plugins: ['gatsby-theme-youtube']
  1. Start your site
gatsby develop



Note: You will need an API key from YouTube to use this theme.

By default, the theme displays 6 videos from the Gatsby YouTube account.

Default gatsby-config.js:

	path: `.env.${process.env.NODE_ENV}`

module.exports = {
	siteMetadata: {
		title: 'Gatsby Theme YouTube'
	plugins: [
			resolve: 'gatsby-source-youtube-v2',
			options: {
				channelId: ['UCjnp770qk7ujOq8Q9wiC82w'], // Can be array of channel IDs, this is Gatsby's channel,
				apiKey: `${process.env.apiKey}`, // Must register for a YouTube API key,
				maxVideos: 50 // This is default
  1. To change the content provider (YouTube channel), update the channelId.
  2. The apiKey must be updated. I’ve put my YouTube API in an .env file as it is sensitive information. Please visit: https://www.gatsbyjs.org/docs/environment-variables/

*To register for a YouTube API key, please visit: https://developers.google.com/youtube/v3/getting-started

Querying Data

Once changes to the gatsby-config.js file are made, run gatsby develop again. Gatsby comes with GraphQL, so you can visit localhost:8000/___graphql to see what data is available from YouTube. I’ve ran a query in the VideoGrids.js component, but there is a lot of different data to pick from.

query {
	allYoutubeVideo(limit: 6) {
		edges {
			node {
				thumbnail {

Components, Styles, Files

It rhymes :)

As this repository was forked, it comes with the basic Gatsby Layout component, page template, and styling via theme-ui. There are two simple components, VideosGrid and Video. useStaticQuery was used to pull the data from GraphQL and the videos are mapped into Video components.

Changes and Future Updates

If you don’t want to render out the actual videos, you can render out thumbnails with links to the videos, or maybe just links, however you want to structure your Gatsby website.

I would consider using createPages API so each video has its own page instead of all being rendered on one page. UI can also be updated and improved as it is very simple currently.

© 2023 Gatsby, Inc.