Storyblok Raises $80M Series C - Read News

Skip to main content

How to add Youtube to Headless CMS

Try Storyblok

Storyblok is the first headless CMS that works for developers & marketers alike.


On May 13th, 2024, Storyblok started gradually rolling out a new design for its Visual Editor. Therefore, the Visual Editor product screenshots depicted in this resource may not match what you encounter in the Storyblok App. For more information and a detailed reference, please consult this FAQ on the new Visual Editor design.

In this article, we will learn how to add youtube to your headless CMS setup. We will use Storyblok to display how to do this. We will also create a custom field type we will prepare for you.

What is Youtube?

YouTube is an online video sharing and social media platform owned by Google, headquartered in San Bruno, California, and is the second most visited website after Google Search.

Starting afresh

Login to your Storyblok space, for the sake of the article, I’ll be creating a new space, but you can also do this in an existing space. After that, click on the Home entry.

Storyblok Home component

Storyblok Home component

Component setup

Now, we will create a Youtube component to handle youtube content. Click the Add block {1} button on the right sidebar to create a new component.

Creating a new block for youtube

Creating a new block for youtube

Type in Youtube {1} since we do not have an existing Youtube component. You’ll see a Create new "Youtube" {2} with which you can add the new component under the input. When you click on that button, you’d see a search bar that allows us to search for an existing component or add a new one.

Creating a field type for youtube block

Creating a field type for youtube block

You’ll be prompted to define the component’s (Youtube) schema on adding the component. Schema is the properties of a component, and since we want to show videos with the Youtube component.

we should have a property of type Text {1} that holds the video URL, so let’s add a property video.

To do this, enter the property name in the input and click the Add {2} button on the right-hand side.

On adding that property, you should see the property under the General tab, as shown in the image below.

Storyblok youtube component

Storyblok youtube component

Click on the Youtube component, copy and paste a youtube video URL in that field and click on Save {1} at the top left of the page.

We have to fetch the Youtube component on the frontend of our app, get the video URL, and embed it in an iframe. 

Storyblok Youtube component

Storyblok Youtube component

Showing the Youtube Video

They are many ways to fetch your Storyblok space content. In this tutorial, I will use the @Storyblok/js npm package.

  • First, let’s fetch the space:
      import { StoryblokInit, apiPlugin } from "@Storyblok/js";

const { StoryblokApi } = StoryblokInit({
  accessToken: [YOUR_ACCESS_TOKEN],
  use: [apiPlugin],

  let videoId;

  const fetchStory = async () => {
    try {
      const { data } = await StoryblokApi.get("cdn/stories/home", {
        version: "draft",
      const youtubeComponent = data?.story?.content?.body?.find(
        (item) => item.component === "Youtube"
      const video_id = () => {
        if (
        ) {
        } else if (youtubeComponent?.video?.startsWith("")) {
      videoId = video_id;
    } catch (err) {


Above we fetched stories on home page and checked for the Youtube component. Then we wrote a function to split the URL and get the videoID because youtube embed URL is different from the usual video URL.

  • With the video ID, we can now play the video using an iframe:
      title="YouTube video player"
      allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"


We’ve learned how to create a component for Youtube and how to fetch it and embed it into an iframe. We also saw that adding this component to a new or existing space is possible.


Fortune Ikechi

Fortune Ikechi

Fortune Ikechi is a Software Engineer proficient with MERN stack and lover of Golang. Fortune is passionate about community building and open source.