Styling Widgets with Widget Templates

You can use widget templates to customize the appearance and functionality of out-of-the-box widgets, such as the Asset Publisher and Media Gallery widgets.

Creating a Widget Template

1. From the Site Menu , click Design → Templates.

2. Go to the Widget Templates tab.

   

3. Click Add () and select a widget for the template (e.g., Asset Publisher).

   

4. Add a name for your widget template.

5. Enter your FreeMarker script into the template editor. You can use the Elements side panel ( ) to add fields, variables, and utilities to your template. Alternatively, you can type ${ to see field suggestions.

   Note

   For Liferay DXP/Portal 7.4+, widget templates only support FreeMarker. Velocity is no longer supported.

6. Click Save.

This creates a new widget template, which you can apply to the corresponding type of widget on a page.

Applying a Widget Template

1. Click Options () in the widget header → Configuration.

   Note

   Before Liferay DXP 2025.Q1, the Configuration option appeared in the widget’s top-right corner.

2. Find the Display Template drop-down menu and select the desired template.

   

   Note

   This drop-down menu is on the default tab, Setup, for most widgets. For the Asset Publisher widget, this setting is under the Display Settings tab.

3. Click Save.

   

The widget now uses the custom template. By using more advanced widget template scripts, you can further enhance the capabilities of your widgets.

Related Topics

• Creating a Widget Template
• Configuring Widget Look and Feel