Knowledge Base

Search

  • Video block
  • Video Tutorials

  • Watch our easy-to-follow video tutorials for quick tips on designing and managing your store.
  • View Video Tutorials

Standard Block Layout

In the following diagram, the block names that can be used to refer to a block in the layout are black, and the block types, or block class paths, are blue.

Standard Block Layout
Standard Block Layout
Block Type Description

page/html

There can be only one block of this type per page. The block name is “root,” and, it is one of the few root blocks in the layout.You can also create your own block and name it “root,” which is the standard name for blocks of this type.

page/html_head

There can be only one block of this type per page. The block name is “head,” and it is a child of the root block. This block must not be removed from layout.

page/html_notices There can be only one block of this type per page. The block name is “global_notices,” and it is a child of the root block. If this block is removed from the layout, the global notices will not appear on the page.
page/html_header There can be only one block of that type per page. The block name is “header,” and it is a child of the root block. This block corresponds to the visual header at the top of the page, and contains several standard blocks. This block must not be removed.
page/html_wrapper Although included in the default layout, this block is deprecated, and only is included to ensure backward compatibility. Do not use blocks of this type.
page/html_breadcrumbs There can be only one block of this type per page. The name of this block is “breadcrumbs,” and it is a child of the header block. This block displays breadcrumbs for the current page.
page/html_footer There can be only one block of this type per page. The block name is “footer,” and it is a child of the root block. The footer block corresponds to the visual footer at the bottom of the page, and contains several standard blocks. This block must not be removed.
page/template_links There are two blocks of this type in the standard layout. The “top.links” block is a child of the header block, and corresponds to the top navigation menu. The “footer_links” block is a child of the footer block, and corresponds to the bottom navigation menu. It is possible to manipulate the template links, as shown in the examples.

page/switch

There are two blocks of this type in a standard layout. The “store_language” block is a child of the header block, and corresponds to the top language switcher. The “store_switcher” block is a child of the footer block, and corresponds to the bottom store switcher.

core/messages

There are two blocks of this type in a standard layout. The “global_messages” block displays global messages. The “messages” block is used to display all other messages. If you remove these blocks, customer won’t be able to see either type of message.

core/text_list

This type of block is widely used throughout Magento, and is used as a placeholder for rendering children blocks.

core/profiler

There is only one instance of this type of block per page. It is used for the internal Magento profiler, and should not be used for other purposes.

See also:

Making XML Layout Updates

Custom Layout Update Syntax

Custom Layout Update Examples

Still have questions? Submit them below and they'll be answered by our expert support team.
Like what you read? Drop us a note with your feedback below.