How to call Cms Block content and html in controller file back end magento2

How to call Cms Block content and html in controller file back end magento2

September 19, 2026 · Illustrated author avatarBy Stefan Bogdanescu
How to call Cms Block content and html in controller file back end magento2

Retrieving CMS Block Content in Magento 2 Controller

Are you working on a custom module for your Magento 2 store and need to retrieve the content of a CMS block from within your controller file? You’re not alone! In this post, we’ll walk through how to call CMS block content and HTML directly inside your controller, using the correct approach in Magento 2.

Understanding the Problem with Your Current Approach

You’ve attempted to use the getLayout()->createBlock('cms/block')->setBlockId('block_identifier')->toHtml() method within your controller. While this might work in some contexts, it’s not recommended practice for a few reasons:

  1. It mixes the concerns of layout and data retrieval.
  2. It can lead to performance issues if used excessively.
  3. It’s less flexible than using Magento’s built-in block retrieval methods.

The Correct Approach: Using the CMS Block Manager

Magento 2 provides a dedicated CMS block manager for retrieving block content. By leveraging this, you can keep your controller code clean and efficient. Here’s how to do it:

public function execute()
{
    $block_id = 'your_block_identifier';
    $cmsBlockModel = $this->getBlockFactory()->create();
    $htmlContent = $cmsBlockModel->setBlockId($block_id)->toHtml();

    // Now you can use $htmlContent within your controller
}

In this example, replace 'your_block_identifier' with the actual ID of the CMS block you want to retrieve. The $this->getBlockFactory()->create() line creates a new Magento\Cms\Model\Block object for interacting with the CMS blocks.

Exploring Best Practices

To make your code even more maintainable and efficient, consider these best practices:

  1. Use Dependency Injection: Magento uses dependency injection heavily. Instead of directly calling $this->getBlockFactory()->create(), inject the factory into your constructor:

    public function __construct(\Magento\Cms\Model\Block $block)
    {
        $this->_block = $block;
    }
    

    Then you can call $this->_block in your method.

  2. Cache the Block Content: If you’re displaying static content, consider caching the block to improve performance. Magento’s cache system is already integrated into the CMS block retrieval process.

Conclusion: Retrieving Blocks Effectively

Remembering these steps will help you retrieve CMS blocks from within your controllers efficiently and cleanly:

  1. Identify the CMS block identifier you want to retrieve.
  2. Inject or create a Magento\Cms\Model\Block object.
  3. Set the block ID using $cmsBlockModel->setBlockId($block_id).
  4. Retrieve the HTML content using $cmsBlockModel->toHtml().
  5. Use this content within your controller as needed.

By following these guidelines, you’ll keep your Magento 2 controllers lean and maintainable while effectively leveraging the CMS block system.

For more in-depth guides on Magento 2 development best practices and custom module creation, be sure to check out our Magento Development Services at Laravel Company.

Magento 2 Performance Extensions Themes

Our network