Adding Media to a Page

Use Media Blocks in Layout Builder to add a single Media item (Like a Document, Image, or Video) on your Content.

CMS Support

March 16, 2023
minute read time

Use Media Blocks to add media like Images, Videos, Interactive content or single files on your page in Layout Builder.

Media Block Examples

Adding a Media Block

See instructions below on how you may add media to a page using a media block. 

  1. Navigate to the Layout Tab for the content where you would like to add Media 
  2. Select 'Add Media' to add a new Media Block into the page's Layout
  3. Select existing Media from the Library, or select 'Upload' to create new Media.
  4. Once you have added your desired media, select 'Insert Media' to add it to the Media Block in the noed's Layout.. 

 

Screenshot of option to add media block in layout builder in Energy.gov CMS

Step Two: Select 'Add Media' to add a new Media Block into the page's Layout

Screenshot of option to add Media from within the Media Modal

Step Three: Select existing Media from the Library, or select 'Upload' to create new Media.

Screenshot of button used to upload new media

Step Four: Once you have added your desired media, select 'Insert Media' to add it to the Media Block in the noed's Layout.. 

Screenshot of configure button for media block

Editing a Media Block

See instructions below on how to edit an existing Media Block on a page or article: 

  1. Navigate to the Layout tab for the content where you would like to edit a Media Block 
  2. Hover over the top right corner of the Media Block you would like to edit to reveal a grey pencil icon 
  3. Click on the grey pencil icon 
  4. From the options in the drop-down menu, select 'Configure' 
  5. Make your desired changes
  6. Select 'Update' when you are ready to add your changes to the page

Helpful Hint

You can drag and drop media blocks within a section to reorder

Helpful Hint

To learn how to edit the Media node itself, see our CMS Support Article on Editing Media: How to Edit Media 

Optional/ Advanced: Override Fields

For some advanced Customization of your Image and Video Blocks, use Override Text Fields.

  1. Check the Display Override Text Fields checkbox
    1. Note: These override text fields apply only to Image and Video media types.
  2. Optional: add Caption Text Override
    1. Text that appears under the image/video. If the image/video chosen has the "Caption" field filled in, and this field is left blank, that text will display instead.
  3. Optional: add Attribution Text Override
    1. Text that describes the source of the image/video. If the image/video chosen has the "Attribution" field filled in, and this field is left blank, that text will display instead.
  4. Optional: add Alt Text Override
    1. Text that appears in place of an image if an image file cannot be loaded. If this field is left blank, the "Alt" field from the image will display instead.
  5. Optional: add Link URL
    1. For content in the site. start typing the title of a piece of content and select it from the dropdown. You can also enter the node ID number to select the node. 
    2. For external content, make sure it is linked using "https://..."

Any Questions, Comments, or Requests?

Contact us at [email protected]