Page Builder Walkthrough part 1: simple page

Last update: October 31, 2024

CREATED FOR:

Beginner
Intermediate
User

Follow this three-part exercise to become familiar with the Page Builder workspace by creating a simple page that illustrates how easy it is to create content-rich pages of your own design.

Simple Page example

NOTE

These walkthrough exercises are updated to reflect recent changes to the Page Builder workspace in the 2.4.1 release.

Before you begin

Before starting this exercise, it is recommended that you increase the Admin Session Lifetime to prevent the session from timing out while you work.

Verify the required Content Management configuration settings:

WYSIWYG Editor is enabled in the WYSIWYG Options configuration.
Page Builder is enabled in the Advanced Content Tools configuration.

Download the walkthrough image assets

Download the simple-page-assets file and save the file to your local system.
Navigate to the downloaded file and extract the zipped files.

On a Windows system, right-click and choose Extract All files. Then, choose the destination folder and click Extract.

On a Mac system, you can simply double-click the zip file and the move the extracted files to the destination folder.

The folder contains the following image files:

Follow the three parts of this walkthrough in order.

In this part of the Simple Page exercise, you create a page that has a full-bleed row and banner. The row has different background images for desktop and mobile devices.

Page Builder full bleed row with banner

Step 1: Create a page

On the Admin sidebar, go to Content > Elements > Pages.
In the upper-right corner, click Add New Page and do the following:
- To prevent this page from being published in your store, set Enable Page to No.
- For Page Title, enter Simple Page.
Expand the Design section.

Notice that Layout is set to Page -- Full Width by default. In addition to the five standard layout options, Page Builder adds full-width layouts for pages, categories, and products.
If the sample data is available, set New Theme to Magento Luma. Otherwise, you can choose another available theme or leave it blank to use the default theme.

The New Theme setting can be used to override the default theme and to apply a different theme to the page.

NOTE
The Full Width layout can be used only with a compatible theme.
In the upper-right corner, click Save.

When the page is saved, the name Simple Page appears in the upper-left corner of the page.

Step 2: Format the row

Expand the Content section.

This action displays the Page Builder preview with an empty row.

NOTE
The Content Heading field is optional. It is by default, formatted as a heading level 1 (H1) according to the theme. For this exercise, the Content Heading is left blank.
Click Edit with Page Builder or inside the content preview area.

In the expanded Page Builder workspace, the panel on the left provides the content tools you can use to build your content in the stage.
Hover over the empty row to display the toolbox.

Each content container has a toolbox with a similar set of options.
In the Row toolbox, choose the Settings ( icon.
Under Appearance, choose Full Bleed.

The Full Bleed appearance setting extends the left and right borders of the content area of the row and background to the full width of the page.
Scroll down to the Advanced section and set all Margins and Padding settings to 0.

This setting ensures that the banner extends the full width of the row.
To save the settings and return to the Page Builder workspace, scroll up to the top of the page and click Save in the upper-right corner.

NOTE

Page Builder has a new content type called Banner, which is featured in this step. What was previously the Banner option in the Content menu, is now a Dynamic Block.

In the Page Builder panel, expand Media and drag a Banner placeholder to the stage.
Hover over the banner container to display the toolbox.

NOTE
The stage now has two content containers, each with a separate toolbox. Because the banner is nested inside the row, make sure that you are working in the correct toolbox.

In addition to the toolbox, the Upload Image and Select from Gallery buttons are included so you can make quick changes to the banner directly from the stage.
In the Banner toolbox, choose the Settings ( ) icon.
Under Appearance, choose Collage Right.

The Collage Right setting positions content on the right side of the banner.
Scroll down to the Background section and set the background image for the banner:
- For Background Image, click Upload.
  
  Navigate to the directory where you saved the extracted simple page assets and choose the wide-banner-background.jpg file.
  
  The image is uploaded and a thumbnail of the uploaded image appears. The file name, image dimensions, and file size are noted below.
- For Background Mobile Image, click Upload.
  
  In the same file directory, choose the wide-banner-background-mobile.jpg file.
  
  The mobile background image is used for mobile devices, and also whenever a desktop browser window is resized to the width of a mobile device.
- Scroll back to the top of the page and click Save to save the settings and return to the Page Builder workspace.
  
  The background appears on the stage and extends the full width of the row.
Notice the placeholder text that appears on the right side of the row. The position of this text reflects the Collage Right appearance setting.
Click the placeholder text, and enter the following message as two lines:

Get fit and look fab in new seasonal styles.

New LUMA yoga collection

The editor toolbar appears above the text box. Text can be entered and formatted either directly from the stage, or by choosing Settings in the banner toolbox.
Apply formatting to the text:
- Select the first line of text. Then, on the editor toolbar under Formats, choose Heading 2.
- Select the second line of text. Then, on the editor toolbar under Formats, choose Paragraph.
The format settings apply the styles from the style sheet that is associated with the current theme.

__
Hover to display the Banner toolbox, choose the Settings ( ) icon again, then scroll to the Content section.

Notice that your text is displayed in the Message Text box. Text can be entered and edited either from the stage or from the Content section of the banner settings.
Continuing in the Content section, set the banner link and button:
- Set Link to Category, and then click Select to show the category tree.
- Choose What's New as the linked category.
- Set Show Button to Always.
- For Button Text, enter Shop Now as the text that appears on the button.
- For Button Type, accept the Primary default.
  
  The button style from the current theme determines the button format.
Set the banner overlay:

You can use an overlay to apply a background color to the active content area that is defined by the Appearance setting. The banner background image remains visible for the full width of the banner.
- Set Show Overlay to Always.
- For Overlay Color, do one of the following:
  - Click the color square and choose the white swatch.
  - Click in the No Color text box and enter White or the hexadecimal value #ffffff.
  Then, click Apply.
- Scroll back to the top of the page and click Save to save the settings and return to the Page Builder workspace.
  
  The button appears below the banner message on the stage.
In the upper-right corner of the stage, click the Close Full Screen ( ) icon.

Clicking this icon returns you to the Content section for the page with the preview displayed.

You can toggle between the two workspace modes at any time you want.
In the upper-right corner, click the Save arrow and choose Save & Close.
If prompted, click the Cache Management link in the message at the top of the page and refresh any invalid cache.

Part 2: Contained row with two equal columns

In this part of the exercise, you add a row to the page, and divide the row into two equal columns. Then, you add a linked image to each column. In the instructions, each new row is added before the first row to make the Page Builder panel line up with the stage. At the end of the exercise, you rearrange the rows so they match the Simple Page example.

Example page using contained row with two equal columns

Step 1: Add a row

In the Pages grid, find the Simple Page that you created in the first part of this exercise and select Edit in the Action column.
Expand the Content section.
Click Edit with Page Builder or inside the content preview area.
In the Page Builder panel under Layout, drag a Row placeholder to the stage and place it above the banner.

The red guideline marks the boundary between the two rows.
Hover over the new row to display the toolbox and choose the Settings ( ) icon.
Under Appearance, accept the Contained default setting.

This setting limits the content area of the row to the width of the page as defined by the theme.
In the upper-right corner, click Save to save the settings and return to the Page Builder workspace.

Step 2: Add a column

In the Page Builder panel under Layout, drag a Column placeholder to the new row.

The row is now divided into two columns of equal width. Each column is a separate container for content with its own dedicated toolbox of options.
In the upper-left corner of the first column, click the circular Grid control ( ) to show the grid guidelines.

The grid ensures that content is aligned consistently, and that it renders correctly on both desktop and mobile devices. For information about configuring the grid size, see the Configure Page Builder section in the Page Builder Setup topic.

The numbers in parentheses (6/12) in the top border of each column container indicate the number of grid divisions in each column, and the total number of divisions in the row.

Step 3: Add images with links

In this step, you learn how to upload an image to the banner.

In the Page Builder panel, expand the Media section and drag an Image placeholder to the first column.
Insert the sample image into the placeholder.

For am image that is located on your system, you can choose either of these methods:
- Upload the image file: In the first column, click Upload Image. Then, navigate to the directory where you saved the extracted simple page assets and choose the small-banner-1.jpg file.
  
  Repeat this action to add the small-banner-2.jpg file to the second column.
- Drag the image file: On your desktop, open the simple page assets folder and position it alongside the Admin browser window where you are working with the Page Builder stage. Then, drag the file small-banner-1.jpg from the simple page assets folder, and drop it in the first column.
  
  Repeat this action to add the small-banner-2.jpg file to the second column.
Determine which page from your catalog that you want to link to each image.
Hover over the image in the first column to display the toolbox and choose the Settings ( ) icon.
Link the image to a category:
- Scroll down and set Link to Category.
- In the category tree, drill down and choose the Men's Hoodies & Sweatshirt category.
- In the upper-right corner, Save the settings and return to the Page Builder workspace.
Repeat the previous step to link the image in the second column to the Gear category.
In the upper-right corner of the stage, click the Close Full Screen ( ) icon.

Clicking this icon returns you to the Content section for the page with the preview displayed.
In the upper-right corner, click the Save arrow and choose Save & Close.
When prompted, click the Cache Management link in the message at the top of the page and refresh any invalid cache.

Part 3: Full-width row with unequal columns

The final row on this page features content from a product review. You add a full-width row and divide it into two columns of different widths. A background image is added to the first column, with a matching background color that is applied to the row for a unified effect.

Example full width row with columns of different widths

Step 1: Add a row

In the Pages grid, find the Simple Page that you created in the first part of this exercise and select Edit in the Action column.
Expand the Content section.
Click Edit with Page Builder or inside the content preview area.
In the Page Builder panel under Layout, drag a Row placeholder to the stage and place it above the row that was created in the second part of this exercise.

A red guideline marks the boundary between the two rows.
Hover over the new row to display the toolbox and choose the Settings ( ) icon.
On the Edit Row page Under Appearance, choose Full Width.

This setting limits the content area to the maximum page width that is defined by the theme. The background color and/or image are not limited, and extend the full width of the row.
In the Background section, enter #f1f1f1 as the Background Color.
Scroll down to the Advanced section and set all Margins & Padding values to 0.
Scroll back to the top of the page and click Save to save the settings and return to the Page Builder workspace.

The background color of the row is now a pale beige.

Step 2: Add columns of different widths

In the Page Builder panel under Layout, drag a Column placeholder to the top row on the stage.
Drag the right border of the first column to the four of 12 (4/12) position on the grid.

The size of the second column adjusts to eight of 12 (8/12).
Hover over the first column container to display the toolbox and choose the Settings ( ) icon.
Scroll down to the Advanced section and set all Margins & Padding values to 0.
Scroll back to the top of the page and click Save to save the settings and return to the Page Builder workspace.

Step 3: Add an image to the first column

In the Page Builder panel, expand Media and drag an Image content type to the first column.
In the image placeholder, click Upload Image.
Navigate to the directory where you saved the extracted simple page assets and choose the review-image.jpg file.

The uploaded image appears in the first column, and blends seamlessly with the background color of the row.

Step 4: Add review content to the second column

The second column of the row should contain content from a customer review, including the five-star rating image and formatted text message.

In the Page Builder panel, expand the Elements section and drag the Text content type to the second column.
Click in the text element to display the editor toolbar.
In the toolbar, click the Insert Image ( ) icon and do the following:
- In the Insert/edit image dialog, click the Find ( ) icon next to the Source field.
- On the Select Images page, click Choose Files.
- In the folder where you saved the simple page assets, choose rating.png.
- Back on the page, double-click the image tile to select it and insert its URL into the Source field.
- For Image Description, enter 5-Star Rating and click OK to insert the image into the column.
- In the editor toolbar, click Align Center ( ) to center the image in the column.
Position the insertion point just after the five-star image, press the Enter/Return key to start a new line, and enter the following text:

Awesome Tank!

I'm a long distance runner and it keeps me pretty comfortable, although these companies always act like their shirts are magical and really it's just pretty basic stuff. Still it's a great shirt, and I would recommend it.

Antonia Racer Tank – Reviewed by Allyson

The text is centered as you type.
Format the text:
- Click anywhere in the first line of text and on the editor toolbar under Formats, choose Heading 2.
- Select the remaining text and on the editor toolbar under Formats, choose Paragraph.
The text is formatted according to the style sheet that is associated with the theme.
Get the dimensions of the image so that you can center the content vertically in the column:
- Hover over the image in the first column to display the toolbox and choose the Settings ( ) icon.
- Below the thumbnail of the image, take note of the dimensions of the image.
- In the upper-right corner, click Close.
Center the content vertically in the second column:
- Hover over the second column to display the toolbox and choose the Settings (
  
  ) icon.
NOTE
Make sure to select the column container rather than the Text container to display the correct toolbox.
- For Minimum Height, enter 450 as the height in pixels for the image in the first column.
- Set Vertical Alignment to Center.
Scroll down to the Advanced section and set all Margins and Padding values to zero ( 0 ).
Scroll back to the top of the page and in the upper-right corner, click Save to save the settings and return to the Page Builder workspace.

Step 5: Insert a catalog product link

Select the Antonia Racer Tank text and click the Insert Link ( ) icon in the editor toolbar.
In the Insert link dialog, specify the link to the catalog product:
- Enter the product URL.
  
  You can enter either a relative or fully qualified URL. The following relative link is entered for this example:
  
  ../antonia-racer-tank.html
- (Optional) For Title, enter the product name.
  
  The Title link attribute is used by some browsers as a tooltip.
- When complete, click OK to save the link.
  
  The linked text is now highlighted in the banner.
In the upper-right corner of the stage, click the Close Full Screen ( ) icon.

Clicking this icon returns you to the Content section for the page with the preview displayed.
In the upper-right corner, click Save.

Step 6: Rearrange the rows

With all three rows complete, the final step is to rearrange the rows to match the original Simple Page example. To match the original example, the first row must be moved to the bottom, and the last row must be moved to the top.

If necessary, expand the Content section.
Click Edit with Page Builder or inside the content preview area.
Hover over the first row on the stage to display the toolbox and choose the Move ( ) icon.
Hold down the mouse button as you verify that all content in the row is selected and drag the row into position below the red guideline at the bottom of the page.

NOTE
If you accidentally move only part of the content — such as the image — simply move the content back where it belongs, and try again.
Repeat this process to move the first row to the second position.

The order of the rows on your page now matches the Simple Page example.
In the upper-right corner of the stage, click the Close Full Screen ( ) icon.

Clicking this icon returns you to the Content section for the page with the preview displayed.
In the upper-right corner, click the Save arrow and choose Save & Close.
If prompted, click the Cache Management link in the message at the top of the page and refresh any invalid cache.