Always define a parent when creating nodes in onCreateNode  📥 👩‍👧

TLDR: When using the action createNode inside onCreateNode it is super duper important to give the node a parent!

On yesterday's unauthorized and rum-fueled treasure hunt in the sharky waters around the Gatsby islands, we worked through the code from the last two emails:

Screengrab of stream

But we also briefly touched on a bug I had to fix from last week's ImageCDN stream. The YouTubeThumbnail nodes were "lost" between builds... 😱

Gatsby caches nodes between builds. If you call createNode with the same nodeId and content digest as a cached node, Gatsby will not go through the node creation process again. It will use the cached node, skipping onCreateNode for that node.

Since caches can get out of hand, Gatsby throws out all nodes that are not "touched" during the node sourcing phase. And this is where our problem arises.

A node is considered touched either by the use of createNode or touchNode. However, the code "touching" our YouTubeThumbnail nodes is skipped when its YouTube node is cached.

Luckily a node is also considered "touched" if its parent is "touched": problem solved 👩‍👧

  id: youTubeThumbnailNodeId,
  parent:, // 👈 👈 👈
  youTubeId: node.youTubeId,
  url: node.oEmbed.thumbnail_url,
  mimeType: "image/jpeg",
  filename: node.youTubeId + ".jpg",
  height: node.oEmbed.thumbnail_height,
  width: node.oEmbed.thumbnail_width,
  internal: {
    contentDigest: node.internal.contentDigest,

All the best,
Queen Raae

You might also be interested in...

Stuck on a reef in the sharky waters around the Gatsby islands?

Book a 1-on-1 Gatsby Call with Queen Raae. Friendly advice you can put into action immediately, guaranteed!

Serious about Gatsby? Sign up for emails sent every weekday to help you get the most out of Gatsby!