Adding YouTube video to product and CMS pages Magento

Adding YouTube video to product and CMS pages Magento

July 22, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Adding YouTube video to product and CMS pages Magento

Solving the Mysterious Magento Video Error

As an experienced Magento developer, I’ve encountered many challenges when trying to integrate YouTube videos into product pages and CMS layouts. Let’s dive into the issue you’re facing and find a solution together.

Understanding Your Current Setup

You’ve already made some progress by creating a custom attribute videoid in your Magento store. This allows you to store the unique video ID for each product or content page. The code you placed in the catalog/product/view/video.phtml file appears correct:

<?php $attStuff= $_product->getData(); ?>
<?php if( !empty( $attStuff['videoid'] ) ): ?>
<iframe width="330" height="253" src="http://www.youtube.com/embed/<?php echo $attStuff['videoid']; ?>" frameborder="0" allowfullscreen></iframe>
<?php endif; ?>

This PHP code checks if the videoid attribute is not empty. If it exists, it embeds the YouTube video on the page using an iframe.

The Layout Update Challenge

The layout update you’ve added looks good at first glance:

<reference name="right">
  <block type="core/template" name="catalog.product.video"
    template="catalog/product/view/video.phtml" />
</reference>

This aims to add the video block to the right sidebar of your CMS page. However, there seems to be a critical issue with how you’re referencing the videoid attribute in your layout update.

The Missing Piece: Product Context

The problem lies in the context of your layout update. When you reference a CMS page as a layout container, Magento doesn’t automatically provide access to the current product object ($_product).

In your case, the catalog.product.view.video.phtml template is expecting a valid product object to call $_product->getData(). Since that object isn’t available in the context of a CMS page, you’re getting a “Call to a member function getData() on a non-object” error.

A Pragmatic Solution

To resolve this issue, we need to adjust our approach. Instead of trying to embed videos directly in the layout update, let’s create a custom block that can handle the video embedding logic independently from the product context.

Here are the steps I recommend:

  1. Create a new block type, for example, catalog/product/video. You can do this by adding a new file named catalog/product/video.php under your theme directory in app/code/local/YourCompany/VideoBlock/etc/config.xml:
<config>
  <global>
    <blocks>
      <yourcompany_product>
        <class>YourCompany_Product_Block</class>
      </yourcompany_product>
      <yourcompany_video>
        <class>YourCompany_Video_Block</class>
      </yourcompany_video>
    </blocks>
  </global>
</config>
  1. In your app/code/local/YourCompany/VideoBlock/Block/Catalog/Product/Video.php file, implement the logic to display the video:
<?php

class YourCompany_Video_Block_Catalog_Product_Video extends Mage_Core_Block_Template
{
    public function getVideoId()
    {
        if ($this->getData('video_id')) {
            return $this->getData('video_id');
        }
        return null;
    }

    public function getVideoUrl()
    {
        $videoId = $this->getVideoId();
        if ($videoId) {
            return "http://www.youtube.com/embed/$videoId";
        }
        return false;
    }
}
  1. Update your layout XML to use the new block:
<reference name="right">
  <block type="yourcompany_video/catalog_product_video"
         template="catalog/product/view/video.phtml" />
</reference>
  1. In your video.phtml file, update the code to use the new block’s methods:
<?php if ($this->getVideoUrl()): ?>
    <iframe width="330" height="253" src="<?php echo $this->getVideoUrl(); ?>" frameborder="0" allowfullscreen></iframe>
<?php endif; ?>

Conclusion

Remember, the key to solving this issue was understanding the context of your layout update and creating a separate block that can handle the video embedding logic independently. This approach ensures that you don’t rely on the product object in your CMS page context.

For more insights into Magento development best practices, feel free to explore our blog at https://laravelcompany.com/tag/magento. We cover a wide range of topics to help you become a more proficient Magento developer.

Catalog Themes Orders Errors

Our network