Where Do I Put a Template To Add Using {{block type="core/template" template="template.phtml"}}

Where Do I Put a Template To Add Using {{block type="core/template" template="template.phtml"}}

October 4, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Where Do I Put a Template To Add Using {{block type="core/template" template="template.phtml"}}

Adding PHP to Magento CMS Pages: A Step-by-Step Guide for Beginners

Welcome to our Magento tutorial series! Today, we’re going to tackle a common question from new Magento developers: how to add PHP logic to CMS pages using templates and blocks.

Understanding the Block Syntax

The syntax {{block type="core/template" template="template.phtml"}} is used to insert server-side content (like PHP) into your Magento CMS page. Let’s break it down:

  • {{block }}: This is a block directive, which allows you to include external content.
  • type="core/template": Specifies the block type as a core template.
  • template="template.phtml": The name of the PHP file (template) that contains your custom logic.

Where to Place Your Custom Template

The key question is - where do you actually put this template.phtml file? Here’s the step-by-step process:

  1. Navigate to Your Theme Directory: In your Magento root folder, locate your active theme directory under app/design/frontend/{package}/{theme}/.

  2. Create a Custom Templates Folder: Inside your theme directory, create a new folder called templates. If it already exists, great! Proceed to the next step.

    /app
        /design
            /frontend
                /Your_Theme_Package
                    /Your_Active_Theme
                        /templates
    
  3. Create Your PHP Template File: Inside this templates folder, create your custom .phtml file. Let’s name it your-template.phtml for this example.

    /app
        /design
            /frontend
                /Your_Theme_Package
                    /Your_Active_Theme
                        /templates
                            - your-template.phtml
    

What to Include in Your PHP Template

Inside the your-template.phtml file, you can include any valid PHP code, including calls to Magento classes and functions. For example:

<?php echo $this->getPriceHtml($_product); ?>

This line gets the price HTML for a product using the getPriceHtml() function provided by the block.

Remember to follow Magento’s coding standards when writing your PHP logic inside these template files.

Including Your Custom Template in a CMS Page

Now that you have created and saved your your-template.phtml file, you can include it in any CMS page using the block syntax we mentioned earlier:

{{block type="core/template" template="Your_Theme_Package/Your_Active_Theme/templates/your-template.phtml"}}

Replace Your_Theme_Package and Your_Active_Theme with your actual theme package and theme names.

Conclusion

In this tutorial, we’ve covered how to:

  • Understand the block syntax for including PHP logic in Magento CMS pages.
  • Determine where to place your custom .phtml template files.
  • Create a simple PHP template file with valid Magento code.
  • Include your custom template in an actual CMS page.

Remember, while this method is useful for adding simple PHP logic, for more complex functionality, you might want to consider creating custom blocks or using plugins for better performance and maintainability.

Themes Pricing

Our network