Guide to create CMS Blocks in Adobe Commerce (Magento Commerce)

Did you know that you can add reusable, custom content to virtually any area or page of your Magento online store in a simple, scalable way?  Magento’s **CMS Blocks** are designed exactly for this. These modular, static content blocks allow you to incorporate text, images, videos, widgets, calls to action, and much more, and then place that content wherever it adds the most value in your storefront—without needing to touch the theme code each time.

By working with CMS Blocks, your team can centralize frequently used content (for example, promotional banners, compliance notices, trust badges, cross-sell sections, or support information) and manage it from a single place. Any update you make to the block is automatically reflected everywhere it is used, which reduces operational effort, minimizes errors, and helps maintain a consistent brand experience across the entire site.

In this article, we will show you why CMS Blocks are such a powerful capability for both marketing and ecommerce teams, and how you can start creating, configuring, and deploying them in your Magento store step by step. You will learn where to find them in the admin panel, how to structure your content for reuse, and how to insert blocks into your pages and layouts so you can optimize your customer experience and respond faster to commercial needs.

Content

• What is a CMS Block?

• Why should you use CMS Blocks?

• How to create and use CMS Blocks?

Whatis a CMS Block?

A CMS block in Magento Commerce is a modular unit of reusable content that you can configure once and deploy in many places across your storefront. In practical terms, a block acts as a self-contained content component that can be independently created, edited, activated, or disabled from the admin panel, without requiring changes to the store’s theme files or custom development each time you want to adjust messaging.

These blocks provide a flexible way to build and manage content that can be added to different pages (home, category, product, landing pages) and layout areas (headers, footers, sidebars, banners, or custom sections) in an online store. Because the same block can be referenced in multiple locations, it becomes much easier to maintain consistency in your brand communication and roll out changes globally—for example, updating a promotion, a legal disclaimer, or a trust badge once and having the update reflected everywhere.

Within a CMS block, you can combine text, images, videos, widgets, and dynamic elements such as product lists or call-to-action buttons, as well as custom HTML if needed. This makes blocks a powerful tool not only for basic informational content, but also for creating richer, conversion-oriented experiences—like promotional hero sections, cross-sell and upsell modules, announcement bars, or support and FAQ snippets—while keeping content management centralized, scalable, and efficient.

Why should you use CMS Blocks?

Here are some of the reasons why you should use blocks:

• Flexibility: Blocks allow you to add and customize content in different areas and pages of the online store. This means that promotional or informational content can be added anywhere in the store.
  
  
• Reuse: Blocks can be created once and reused across multiple pages. This is especially useful for content that appears on multiple store pages, such as a promotional banner.
  
  
• Version Control: Blocks allow you to version control your content, which means you can easily update your content without having to change it on every page it appears on.
  
  
• Personalization: Blocks allow for content customization using the Magento block visual editor. This means that you can easily create content that matches the brand and style of the online store.
  
  

How to create and use CMS Blocks?

1. To create a block you must first go to the section Content > Elements > Blocks:
   
   
   

2. In this tab you can see the list of the existing blocks, to create a new block just click on the "Add New Block" button:
   
   

3. You must add a title, an identifier, and the content you want to display in your block. Then press the save button and you will have your block created:
   
   

4. Now that you have your block, you must create a page where you can add it to display it. To do this go to the section Content > Elements > Pages:
   
   

5. In this tab you can see the list of existing pages, to create a new one simply click on the "Add new Page" button:
   
   

6. You must add the title of the page and click on the "Insert Widget" button:
   
   
   

7. Select the "CMS Static Block" option:
   
   

8. You must select the block you previously created:
   
   
   
   

9. Then click on “Insert Widget”:
   
   

10. The code to display that block will be automatically added to your page:
    
    

11. You just must save the changes and now you can see the content block you have created:
    
    

In this example we simply add a title element to the block, but remember that you can create blocks with much more elaborate content and styles:

Blocks are a valuable feature in Magento Commerce that enable online store admins and marketing teams to add, manage, and optimize content in a flexible and efficient way. Instead of relying on developers for every change, you can use blocks to quickly introduce new messages, promotions, and visual elements directly from the admin panel.

Because blocks are easy to create and customize, you can adapt their content to different audiences, seasons, or campaigns with just a few clicks. The same block can be reused across multiple layout areas and pages—such as the homepage, category pages, and product detail pages—ensuring consistent messaging while significantly reducing maintenance effort. When you update a block, the change is automatically reflected everywhere that block is used, which helps maintain brand coherence and minimizes the risk of outdated or inconsistent information.

In addition, blocks support version control of content, allowing you to schedule changes, roll back to previous versions, and test different variants over time. This makes it easier to experiment with new messages, creative assets, and calls to action, while maintaining governance over what is published.

All these factors—flexibility, reuse, centralized management, and version control—make blocks a powerful tool to improve the user experience, provide more relevant and timely information to your customers, and ultimately increase key ecommerce metrics such as conversion rate, average order value, and total sales of your online store.