After July 2021, the 2.3.x release line will no longer receive quality fixes, or user guide updates. PHP 7.3 reaches end of support in December 2021 and Adobe Commerce 2.3.x reaches end of support in April 2022. We strongly recommend planning your upgrade now to Adobe Commerce 2.4.x and PHP 7.4.x to help maintain PCI compliance.

Positioning Blocks

The code that controls the page layout and placement of blocks is written in XML Widgets to make it easy to position a block at a specific place on the page, and even for a specific product or category without writing any code. You can choose each option from a list, rather than trying to remember all of the possible combinations.

The following list describes the locations by page type where blocks are typically placed. For more information about how areas on the page are defined, see Standard Page Layouts.

Category and CMS pages

Block reference Position
Breadcrumbs The navigation aid at the top of many pages that shows your current location as a link. Any additional content placed in the breadcrumbs reference floats to the right of the breadcrumbs, if displayed.
Left Column Content is added to the left column.
Main Content Area Content is added to the main content area.
My Cart Extra Actions Content appears below the Cart Subtotal when the customer clicks the cart icon at the top of the page.
Navigation Bar Content appears below the main navigation bar.
Page Bottom Content appears at the bottom of the page.
Page Footer Content appears above the footer of the page.
Page Header Content appears below the header of the page.
Page Top Content appears at the top of the page.
Right Column Content appears in the right column.
Store Language Content appears in the upper-left corner of the header.

Product page

Block reference Position
Alert URLs Content appears below the title of the product on the product detail page.
Bottom Block Options Wrapper If custom options are added, content appears below the Add to Cart button.
Breadcrumbs Content appears to the right of breadcrumbs—the navigation aid that provides links as a path that is showcased below the navigation bar.
Info Column Options Wrapper If a custom options are added, content appears to the right. The same location applies to configurable options.
Left Column Content appears below the left column blocks.
Main Content Area Content appears below the main content area.
My Cart Extra Actions Content appears below the Cart Subtotal when the customer clicks the cart icon at the top of the page.
Navigation Bar Content appears below the main navigation bar.
Page Bottom Content appears at the bottom of the page.
Page Footer Content appears above the footer of the page.
Page Header Content appears below the header of the page.
Page Top Content appears at the top of the page.
PayPal Express Checkout (Payflow Edition) Shortcut Wrapper If the PayPal payment method is enabled, content appears below the PayPal buy button.
PayPal Express Checkout Shortcut Wrapper If the PayPal payment method is enabled, content appears below the PayPal buy button.
Product Tags List Content appears below the products tag bar.
Product View Extra Hint Content appears below the main top price of the product.
Right Column Content appears below the right column blocks.
Store Language Content appears to the right of the language chooser.
Tags List Before Content appears above the Add Your Tags field.