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.

Adding New 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.

Custom blocks of content can be created, and then added to any page, group of pages, or even to another block. For example, you might place an image slider in a block, and then place the block on the home page. The Blocks workspace uses the same basic controls as the Pages workspace to help you find available blocks and perform routine maintenance. When the block is complete, you can use the Widget tool to place it on specific page(s) in your store.

The Blocks page displays a grid of existing blocks Blocks page

Create a block

  1. On the Admin sidebar, go to Content > Elements > Blocks.

  2. In the upper-right corner, click Add New Block.

    The New Block page displays options and a content space Block detail information

  3. If you want to change the default enabled status of the new block, set Enable Block to No.

  4. Assign a Block Title for internal reference.

  5. Assign a unique Identifier for the block.

    Use all lowercase characters with underscores instead of spaces.

  6. Select each Store View where you want the block to be available.

  7. Add the content for the block using the displayed content tool set:

    • If Page Builder is enabled, the content workspace includes the Page Builder tools.

      Page Builder workspace

      For information about adding blocks with Page Builder, see Tutorial 2: Blocks.

    • Use the editor to format text, create links, and add tables, images, video, and audio.

      If you prefer to work with HTML code, click Show / Hide Editor.

      Block editor (hidden)

  8. When complete, click the Save arrow and choose Save & Close.

    The Save menu displays a Save and Close option Choosing the Save & Close option

    The new block appears at the bottom of the list in the Blocks grid.

  9. Use the Widget tool to place the completed block on a specific page in your store.

Save menu

Command Description
Save Save the current block and continue working.
Save & New Save and close the current block, and begin a new block.
Save & Duplicate Save and close the current block, and open a new duplicate copy.
Save & Close Save and close the current block, and return to the Blocks grid.