DocumentationCommercePage Builder

Add Content - Dynamic Block

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

CREATED FOR:

  • Beginner
  • Intermediate
  • User

Use the Dynamic Block content type to add an existing dynamic block to the Page Builder stage.

Dynamic block on the storefront {width="700" modal="regular"}

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.

Dynamic Block toolbox

Tool
Icon
Description
Move
Move icon {width="25"}
Moves the block container and its content to another position on the stage.
Settings
Settings icon {width="25"}
Opens the Edit Block page, where you can choose the block and change the properties of the container.
Hide
Hide icon {width="25"}
Hides the current block container and its content.
Show
Show icon {width="25"}
Shows the hidden block container and its content.
Duplicate
Duplicate icon {width="25"}
Makes a copy of the block container and its content.
Remove
Remove icon {width="25"}
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 dynamic block to the stage

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

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

    Dragging a dynamic block placeholder to the stage {width="600" modal="regular"}

  3. Hover over the empty dynamic block container to display the toolbox and choose the Settings ( Settings icon {width="20"} ) icon.

    Dynamic Block toolbox {width="600" modal="regular"}

  4. On the Edit Dynamic Block page, click Select Dynamic Block and use the list to select the block.

    Selecting a dynamic block {width="600" modal="regular"}

    In the list, find the dynamic block that you want to insert, and click Select. Then, click Add Selected.

    Selecting a dynamic block in the list {width="600" modal="regular"}

    A summary of the dynamic block information appears below.

    Dynamic Block Summary {width="600" modal="regular"}

  5. Set Template to one of the following:

    table 0-row-2 1-row-2 2-row-2 layout-auto
    Option Description
    Dynamic Block Block Template Adds a standalone block.
    Dynamic Block Inline Template Inserts the block content into text.

    Dynamic block template {width="200"}

  6. Complete the Advanced settings as needed.

  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 dynamic 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 the Border style that is applied to all four sides of the dynamic 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 dynamic 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 dynamic block container settings

  1. Hover over the dynamic block container to display the toolbox and choose the Settings ( Settings icon {width="20"} ) icon.

    Dynamic Block toolbox {width="500" modal="regular"}

  2. If needed, change the dynamic block:

    • Click Select Dynamic Block.

      Selecting another dynamic block {width="20"}

    • In the list of active dynamic blocks, click Select for the block that you want to add.

  3. Update the remaining settings as needed.

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

Duplicate a dynamic block

  1. Hover over the dynamic block container to display the toolbox and choose the Duplicate ( Duplicate icon {width="20"} ) icon.

    The duplicate appears just below the original.

    Duplicating a dynamic block {width="500" modal="regular"}

  2. To move the new dynamic block to a different position, hover over its container, and then choose Move ( Move icon {width="20"} ) in the toolbox.

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

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

Remove a dynamic block from the stage

  1. Hover over the dynamic block container to display the toolbox and choose the Remove ( Remove icon {width="20"} ) icon.

  2. When prompted to confirm, click OK.

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