Documentation

Configuring Fragments

Liferay DXP provides configuration options for Fragments and their sub-elements. These options can vary, though some are common to all. To view available configuration options, begin editing a Page or Template and open the Browser panel (Browser) in the sidebar menu. Then, click on a Fragment or sub-element and select which options you’d like to configure from the available tabs.

Note

Some Fragment configuration fields can be localized. See Localizing Fragment Configuration Fields for more information.

Fragment Configuration Options

Available Fragment configuration options are grouped into two tabs: General or Styles. Nearly all Fragments include both tabs. However, there are some exceptions:

  • HTML, Paragraph, Separator, and Social do not have General settings.

  • Collection Display does not have Styles settings.

With DXP’s Responsive Layout Editor, you can also configure these settings for different viewports.

General

The General tab includes both standard configuration options (e.g., visibility and frame) as well as options unique to each Fragment. See General Settings Reference for more information.

Styles

The Styles tab includes standard options for configuring a Fragment’s style. This includes a Fragment’s dimensions, background, borders, and more. See Configuring Fragment Styles for more information on the available style configurations.

Custom Fragments with more complex structures may require a specific HTML change for style changes to be applied appropriately. See Applying Styles to Fragments for more information.

Advanced

The Advanced tab includes more advanced or technical configurations. This includes hiding Fragments from search results, or changing the HTML generated on a page. See Advanced Settings Reference for more information.

Fragment Sub-Element Settings

Many Fragments include sub-elements with their own configuration options. Available options depend on the sub-element’s type and are organized into tabs: Mapping, Image Source, and Link. See Fragment Sub-Elements Reference for more information.

Mapping

In the Mapping tab, you can map page elements to available assets by selecting the desired item (e.g., web content article, document, blog) and specifying which of its fields to display in the element (e.g., title, author, name).

Image Source

In the Image Source tab, you can select an element’s image, view its resolution, and provide its alt text.