Magento layout cms.xml file with block cms_index_index does not show cms page content. Why?

Magento layout cms.xml file with block cms_index_index does not show cms page content. Why?

July 28, 2026 · Illustrated author avatarBy Stefan Bogdanescu
Magento layout cms.xml file with block cms_index_index does not show cms page content. Why?

Magento Layout XML File Not Displaying CMS Page Content

You’ve encountered an issue where your custom layout cms.xml file isn’t displaying the content of a specific CMS page in your Magento store. Let’s troubleshoot this problem.

Understanding Your Current Setup

Your current layout.xml file contains several blocks and references, especially for handling different CMS pages like the home page (cms_index_index), default index (cms_index_defaultindex), no-route page (cms_index_noroute), and default no-route page (cms_index_defaultnoroute). The issue seems to lie within the configuration for these CMS pages.

Identifying the Problem

The primary issue is that you’re using multiple blocks of type core/template and cms/page in your layout, which might be causing a conflict or overriding behavior. Additionally, the naming conventions and template paths need careful attention.

Block Conflicts

In your cms_index_index reference:

<block type="core/template" name="cms_index_index" template="cms/index/index.phtml" />

And in the same reference:

<block type="cms/page" name="cms_page" />

Both blocks are trying to display content, which could lead to confusion or overriding.

Template Paths and Naming

You’re using templates like cms/index/index.phtml for the core/template block in some places. However, Magento’s default CMS template path is usually set to app/design/frontend/<theme>/layout/cms.xml, which might be causing a conflict if not configured correctly.

Resolving the Issue

1. Simplify Your Block Configuration

Instead of using multiple blocks for the same content in your cms_index_index reference, try merging them:

<reference name="content">
    <block type="cms/page" name="cms_page" template="page/html/cms.phtml"/>
</reference>

This block uses the default Magento CMS page template.

2. Check Your Template Paths

Ensure that your templates are located in the correct directory:

  • The cms/index/index.phtml file should be found within app/design/frontend/<theme>/template/cms.
  • For custom themes created using LESS, make sure to check the generated CSS files for any layout-specific overrides.

You can find more information about Magento theme creation and customization in our guide: Magento Theme Development Explained.

3. Verify Your CMS Page Settings

Double-check that your CMS page is published, and the correct block has been assigned:

  • Go to Content > Pages.
  • Find your specific page (e.g., Homepage).
  • Ensure it’s in “Enabled” status.

Final Steps

After making these changes, clear your Magento cache and rebuild it:

  1. Navigate to System > Cache Management.
  2. Select all cache types and click Flush Cache.
  3. Click the green Apply Changes button at the top right corner of the page.
  4. Re-deploy your static content: Run bin/magento setup:static-content:deploy in your terminal.

If you still face issues, review your layout XML file again to ensure there are no duplicate or conflicting block names and that all references point to the correct template paths.

Indexing Themes Configuration Errors

Our network