Skip to content

Latest commit

 

History

History
140 lines (88 loc) · 7.54 KB

page-builder-elements-heading.md

File metadata and controls

140 lines (88 loc) · 7.54 KB
title redirect_to
Elements - Heading

Heading levels establish a hierarchy that organizes content, and helps search engines index each page. Use the Heading content type in the [Page Builder stage]({% link cms/page-builder-workspace.md %}#stage) to add a text container with a heading level from H1 to H6 to the stage. Headings are formatted according to the style sheet that is associated with the current theme.

The [Content Heading]({% link cms/page-builder-workspace.md %}) field in the Content section can be used to add an H1 heading to the top of the page. However, the field is a legacy from previous Commerce versions and is provided to support older content. Because this field does not take advantage of Page Builder’s advanced features, we recommend that you leave the Content Heading field blank and use the Page Builder Heading content type to add headings of any level to the page.

The following example shows how the Content Heading and the Heading content type appear when formatted by the Luma theme.

![]({% link cms/assets/pb-storefront-heading-levels.png %}){: .zoom} Content Heading and heading Levels on the storefront

You can drag a heading from the Elements section of the Page Builder panel to a row, column, or tab set on the stage. The heading level and alignment can be controlled from the editor toolbar on the stage, or by using the Settings ( ![]({% link cms/assets/pb-icon-settings.png %})) control.

{% include page-builder-save-timeout.md %}

Heading editor

![]({% link cms/assets/pb-elements-heading-toolbar.png %}){: .zoom} Heading editor with toolbar

Heading container toolbox

As with all content containers, the toolbox appears when you hover over the container.

![]({% link cms/assets/pb-elements-heading-toolbox.png %}){: .zoom} Heading container toolbox

Tool Icon Description
Move ![]({% link cms/assets/pb-icon-move.png %}) Moves the heading container to another valid place on the page.
(label) Heading Identifies the current container as a heading.
Settings ![]({% link cms/assets/pb-icon-settings.png %}) Opens the Edit Heading page, where you can change the properties of the container.
Hide ![]({% link cms/assets/pb-icon-hide.png %}) Hides the heading container.
Show ![]({% link cms/assets/pb-icon-show.png %}) Shows the hidden heading container.
Duplicate ![]({% link cms/assets/pb-icon-duplicate.png %}) Makes a copy of the heading container.
Remove ![]({% link cms/assets/pb-icon-remove.png %}) Deletes the heading container and its content from the stage.

Add a heading

  1. In the Page Builder panel, expand Elements and drag a Heading placeholder to a row, column, or tab set on the stage.

    ![]({% link cms/assets/pb-elements-heading-drag.png %}){: .zoom} Dragging a heading to the stage

  2. In the editor, enter the heading text over the Edit Heading Text placeholder.

    By default, the heading text is assigned a level two (H2) heading type.

    ![]({% link cms/assets/pb-elements-header-editor-placeholder.png %}){: .zoom} Placeholder in the heading editor

  3. In the toolbar, choose the appropriate heading type between H1 and H6.

  4. Change the alignment, if needed.

Edit header settings

  1. Hover over the heading container to display the toolbox and choose the Settings (![]({% link cms/assets/pb-icon-settings.png %})) icon.

    ![]({% link cms/assets/pb-elements-heading-toolbox.png %}){: .zoom} Heading toolbox

  2. Update the heading content (Heading Type and Heading Text) if needed.

    This is also available to update in the heading editor.

  3. Update the Advanced settings as needed.

    • Choose an Alignment to control the positioning of the heading within the parent container:

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

    • Set the Border style applied to all four sides of the heading container:

      |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 a inset line. |Outset|The container border appears as a outset line.

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

      • 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.

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

      Separate multiple class names with a space.

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

      Enter the corresponding values in the diagram.

      |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

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

Duplicate a heading

For a formatted heading with specific settings, it is more efficient to duplicate the heading, rather than start over with a new placeholder.

  1. Hover over the heading container to display the toolbox and choose the Duplicate (![]({% link cms/assets/pb-icon-duplicate.png %})) icon.

    The duplicate appears just below the original.

    ![]({% link cms/assets/pb-elements-heading-duplicate.png %}){: .zoom} Duplicating a heading container

  2. Hover over the new heading container to display the toolbox and choose the Move (![]({% link cms/assets/pb-icon-move.png %})) icon.

    ![]({% link cms/assets/pb-elements-heading-move.png %}){: .zoom} Moving a heading

  3. Select and drag the heading until the red guideline marks the new position.

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

    ![]({% link cms/assets/pb-elements-heading-move-guideline.png %}){: .zoom} Moving the duplicated heading into position

  4. If you need to change the heading level, click the heading text and choose the new level in the editor toolbar.

    ![]({% link cms/assets/pb-elements-heading-change-heading-level.png %}){: .zoom} Choosing a new heading Level