Setting Widget Scopes

By default, Liferay’s page widgets are scoped by site. This means all widget instances in a site share the same data and display the same content. For example, adding the Message Boards widget to two pages in the same site creates two copies of the same widget, because they use the same data. Adding the Message Boards widget to two different sites creates two different Message Boards with different data.

You can, however, scope widget instances to the page instead of to the site. Then you can add the Message Boards widget to multiple site pages, and each instance has its own categories and threads.

Liferay provides these scope options for page widgets:




Scope widget data to the current site.


Scope widget data to the Global site. For this scope, you can only manage the widget’s content from the Global site.


Scope widget data to an individual page. You must create the scope when configuring a page widget. Once created, other widgets can use it.

Follow these steps to configure a widget’s scope:

  1. Begin editing a page.

  2. Hover over the desired widget, click its Options button ( Options Button ), and select Configuration.

  3. Go to the Scope tab and use the drop-down menu to select a scope.

    This menu includes the current site (e.g., Liferay DXP), the Global site, the current page, and any other page scopes available in the site.

    If you haven’t created a scope for the current page, its name is followed by (Create New) (e.g., Home (Create New)).

    In the Scope tab, use the drop-down menu to select a scope.

  4. Click Save.

Once you create a new widget scope, a Scope Configuration button (Scope Configuration Button) appears under Content & Data in the Site Menu ( Site Menu ). You can use it to select the default scope or available page scopes. Your selection changes the content that appears when you manage each type.

Use the Scope Configuration button under Content & Data to determine which scope to manage content for.

Additional Information