DocumentationCommercePage Builder

Add Content - Block

Last update: Thu Sep 07 2023 00:00:00 GMT+0000 (Coordinated Universal Time)

CREATED FOR:

  • Beginner
  • Intermediate
  • User

Use the Block content type to add an existing, active block to the Page Builder stage. In the following example, the first column contains the block with a side menu for the page. The second column contains an image.

w-600 modal-image
Block with a side menu
NOTE
If you are making significant changes to Page Builder content, it is recommended that you increase the Admin Session Lifetime to prevent the session from timing out while you work.

Block toolbox

Tool
Icon
Description
Move
Move icon
Moves the block container and its content to another position on the stage.
Settings
Settings icon
Opens the Edit Block page, where you can choose the block, and change the properties of the container.
Hide
Hide icon
Hides the current block container and its content.
Show
Show icon
Shows the hidden block container and its content.
Duplicate
Duplicate icon
Makes a copy of the block container and its content.
Remove
Remove icon
Deletes the block container and its content from the stage.
NOTE
Hidden elements are stored in the database and invisible to customers. However, these elements are visible to search engines and other bots that crawl your site. They are also returned as part of the content if requested through an API call with an attribute of invisibility, unless you remove them from the stage.

Add an existing block

  1. Navigate to the Page Builder workspace on the target page, block, dynamic block, product, or category.

  2. In the Page Builder panel, expand Add Content and drag a Block placeholder to the stage.

    img-md
    w-600 modal-image
    Dragging a block onto the stage

  3. Hover over the empty block container to display the toolbox and choose the Settings (+--------------------------+ | img-md | +==========================+ | w-25 | +--------------------------+ | Settings icon | +--------------------------+) icon.

  4. Click Select Block.

    img-md
    w-200
    Selecting a block

  5. In the row of the block that you want to add, click Select in the last column.

    img-md
    w-600 modal-image
    Selected block

    The name of the selected block appears on the page.

    img-md
    w-200
    Block name

  6. Complete the remaining settings as needed, using the field descriptions at the end of this page for reference.

  7. When complete, click Save to apply the settings and return to the Page Builder workspace.

Advanced Settings

  1. To control the positioning of the block within the parent container, choose an Alignment:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 layout-auto
    Option Description
    Default Applies the alignment default setting that is specified in the style sheet of the current theme.
    Left Aligns the list along the left border of the parent container, with allowance for any padding that is specified.
    Center Aligns the list in the center of the parent container, with allowance for any padding that is specified.
    Right Aligns the block along the right border of the parent container, with allowance for any padding that is specified.

  2. Set a Border style that is applied to all four sides of the block container:

    table 0-row-2 1-row-2 2-row-2 3-row-2 4-row-2 5-row-2 6-row-2 7-row-2 8-row-2 9-row-2 10-row-2 layout-auto
    Option Description
    Default Applies the default border style that is specified by the associated style sheet.
    None Does not provide any visible indication of the container borders.
    Dotted The container border appears as a dotted line.
    Dashed The container border appears as a dashed line.
    Solid The container border appears as a solid line.
    Double The container border appears as a double line.
    Groove The container border appears as a grooved line.
    Ridge The container border appears as a ridged line.
    Inset The container border appears as an inset line.
    Outset The container border appears as an outset line.

  3. If you set a border style other than None, complete the border display options:

    table 0-row-2 1-row-2 2-row-2 3-row-2 layout-auto
    Option Description
    Border Color Specify the color by choosing a swatch, clicking the color picker, or by entering a valid color name or equivalent hexadecimal value.
    Border Width Enter the number of pixels for the border line width.
    Border Radius Enter the number of pixels to define the size of the radius that is used to round each corner of the border.

  4. (Optional) Specify the names of CSS classes from the current style sheet to apply to the container.

    Separate multiple class names with a space.

  5. Enter values, in pixels, for the Margins and Padding to determine the outer margins and inner padding of the block container.

    Enter the corresponding values in the diagram.

    table 0-row-2 1-row-2 2-row-2 layout-auto
    Container area Description
    Margins The amount of blank space that is applied to the outside edge of all sides of the container. Options: Top / Right / Bottom / Left
    Padding The amount of blank space that is applied to the inside edge of all sides of the container. Options: Top / Right / Bottom / Left

Edit block settings

  1. Hover over the block container and choose the Settings (+--------------------------+ | img-md | +==========================+ | w-25 | +--------------------------+ | Settings icon | +--------------------------+) icon in the toolbox.

    img-md
    w-600 modal-image
    Block Toolbox

  2. To choose a different block, click Select Block.

    • In the list of active blocks, click Select the block that you want to add.
    • Click Add Selected.

  3. Update the remaining settings as needed, using the field descriptions at the end of this page for reference.

  4. When complete, click Save to apply the settings and return to the Page Builder workspace.

Duplicate a block

  1. Hover over the block container to display the toolbox and choose the Duplicate ( Duplicate icon ) icon.

    The duplicate appears just below the original.

  2. To move the new block to a new position, hover over the container, and then click Move ( Move icon ) in the toolbox.

  3. Select and drag the block until the red guideline appears at the new position.

    The top and bottom borders of each container appear as dashed lines while the block is moved.

Remove a block from the stage

  1. Hover over the block container to display the toolbox and choose the Remove ( Remove icon ) icon.

  2. When prompted to confirm, click OK.

recommendation-more-help
85b60248-86a4-4d5f-9933-5179643f608d