After July 2021, the 2.3.x release line no longer received quality updates or user guide updates. PHP 7.3 reached end of support in December 2021, and Adobe Commerce 2.3.x reached end of support in September 2022. We strongly recommend upgrading to Adobe Commerce 2.4.x to help maintain PCI compliance.
Positioning Blocks
This site contains archived merchant documentation for a version of Adobe Commerce and Magento Open Source that has reached end-of-support.
The documentation available here is intended for historical reference only and is not maintained.
The Adobe Commerce Merchant Documentation for current releases is published on the Adobe Experience League.
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. |