Documentation

Site Settings UI Reference

The Site Settings application changes significantly in Liferay DXP 7.4+. See Site Settings UI Reference in Liferay DXP 7.2 and 7.3 below for information on previous versions.

Starting with Liferay DXP 7.4, the Site Settings application layout is consistent with other configuration areas, such as Instance Settings or System Settings.

Accessing the Site Settings Application

  1. Go to Site Administration → ConfigurationSite Settings.

  2. Click on a setting to open its configuration.

You can find the following configuration areas:

Site Settings are organized into four areas.

Commerce

By default, the Commerce area includes the following settings:

  • Catalog

  • Orders

  • Payment

  • Shipping

Here you can configure the Commerce settings at the Site scope. For more information about Commerce settings, see Liferay Commerce Configuration Overview.

Default Site Settings for Commerce

Platform

By default, the Platform area includes the following settings:

Analytics

Use these settings to configure the Google Analytics options for your Site. You can also set the Piwik Analytics tracking code.

Note

In the Piwik configuration, enter the full script code including the script start and end tags.

If you require a different analytics service, you can add it. See Adding a New Analytics Service for more information and how to add additional fields for different analytics services.

Localization

Here you can choose whether to use the installation’s default language options or define your own for the Site. For more information on setting your Site’s language options, read Site Localization.

Use the Localization settings to set your Site language options.

Site Configuration

By default, Site Configuration includes the Details and Site URL sections.

Details

Setting Description
Site ID A unique number automatically generated for a Site at its creation. This ID is permanent and cannot be changed.
Description Use the this field to explain a Site’s purpose.
Parent Site Designate a Site as a child Site by selecting its parent Site. See Site Hierarchies for more information.
Membership Type Determines how restrictive a Site’s membership is. See Changing Site Membership Types for more information.
Allow Manual Membership Management Determine whether to allow members to be manually added or removed from a Site. See Changing Site Membership Type for more information.

Site URL

Setting Description
Friendly URL Set a custom URL for both public and private Site pages. See Configuring Your Site’s Friendly URL for more information.
Public and Private Pages Set public and private Virtual Hosts to map to a Site’s Public and Private Pages. See Configuring Virtual Hosts Site URLs for more information.

Third Party

Configure the PunchOut2Go Site setting for Liferay Commerce. For more information, see Liferay Commerce Connector to PunchOut2Go Reference Guide.

Third Party Applications

By default, Third Party Application includes the Maps and Google Places sections.

Section Description
Asset Auto Tagging When enabled, assets are auto tagged by the providers configured at the Instance scope. See Configuring Asset Auto Tagging for more information.
Categorization Use this section to categorize your Site. This setting does not affect the Categories and Tags available for the Site. For more information on using Categories and Tags, see Organizing Content with Categories and Tags.

Users

By default, the Users section includes the Default User Associations setting, where you can configure the default Roles and Teams for new Site members. For more information, see Configuring Role and Team Defaults for Site Members.

Content and Data

By default, the Content and Data area includes the following settings:

Assets

Section Description
Maps Select which maps API provider to use when displaying geo-localized assets in your Site. Geo-localized assets can be displayed for documents, web content articles, DDL records, and more. See Geo-locating Assets for more information.
Google Places API Key Set the Google Places API Key.

Click to Chat

Available: Liferay 7.4 GA2+

You can integrate Liferay DXP with a number of live support chat platforms. The configuration at Site scope depends on the Click to Chat configuration at Instance scope. For more information, read Enabling Automated Live Chat Systems.

You can see the type of configuration for this setting at the Instance scope under the Site Settings Strategy text:

Find the type of configuration at the Instance scope under Site Settings Strategy.

Note

Depending on your configuration at the Instance scope, you may not be able to update the configuration at Site scope. To verify your Instance Configuation, got to the Site Menu → Control Panel → Instance Settings → Content and Data → Click to Chat.

Community Tools

Section Description
Mentions Determines whether to allow Users to mention other Users in Site applications. See Configuring Mentions for more information.
Ratings Here you can select the type of ratings used for the different Site applications. See Configuring Content Rating Types for more information.

Digital Signature

You can integrate Liferay DXP with DocuSign to manage electronic signatures. The configuration at Site scope depends on the Digital Signature configuration at Instance scope. You can check the Instance configuration under the Site Settings Strategy text:

Find the type of configuration at the Instance scope under Site Settings Strategy.

Note

Depending on your Digital Signature configuration at the Instance scope, you may not be able to update the configuration at Site scope. To verify your Instance Configuation, go to Site Menu → Control Panel → Instance Settings → Content and Data → Digital Signature.

Documents and Media

When enabled, a User with view permission can browse the Site’s document library files and folders. For more information, see Securing Site Documents Content.

Message Boards

Using this option, you can enable automatic moderation of user messages on Message Boards after a predefined number of messages.

Configure automatic moderation of Message Boards.

Pages

Section Description
Google PageSpeed Insights (Liferay DXP 7.4+) Enable the Google PageSpeed Insight integration in Liferay DXP. Using this option, you can audit your pages for accessibility issues and check suggestions for fixing them. After you enable Google PageSpeed Insights, you need to provide the API Key and Preferred Strategy.
Open Graph Enable this option to include the Open Graph meta tags in the head of your Site's pages. These tags define page metadata to create engaging representations of your Site’s content when shared in applications that support the Open Graph protocol, such as Facebook, Slack, and Twitter. For more information, read Configuring Open Graph.
Pages View the Site Public and Private pages. On this section, you can also configure the propagation of changes from a Site template, if one exists. For more information, read Building Sites with Site Templates.

Recycle Bin

Configure the Recycle Bin for a Site. You can specify the number of minutes an asset remains in the Recycle Bin before automatic deletion. By default, the max age for recycled items is 43200 minutes (30 days). See Configuring the Asset Recycle Bin for Sites for more information.

Reports

Settings for the Reports Group Service functionality.

Sharing

Section Description
Content Sharing Enable this option to allow child Sites to display content from this Site, including structures, templates, categories, or widget templates. When you disable this option, you immediately revoke content sharing from all child Sites. See Managing Content Sharing Across Sites for more information.
Sharing When enabled, Users can share items with one another. See Enabling and Configuring Sharing for more information.

Other

By default, the Other area includes the following settings:

Section Description
Other Includes custom Site settings you have defined for your Site, if any. For more information, read Setting and Accessing Configurations.
Tax Configure the settings for the Remote Commerce Tax Configuration in Liferay Commerce. For more information, see the Liferay Commerce documentation.
category.tax-rate Configure the settings for the Liferay Commerce Avalara integration. For more information, see the Liferay Commerce documentation.

Site Setting UI Reference in Liferay DXP 7.2 and 7.3

To view a Site’s settings, open the Site Menu (Site Menu) and go to ConfigurationSettings, where you’ll see the following tabs:

Site Settings are organized into four tabs.

Note

Many of these settings can be localized to provide translations based on a user’s locale. See Introduction to Localization and Modifying Localizable Site Fields for more information.

General

General settings range from core configuration, like a Site’s Membership Type, to finer details like Documents and Media indexing options. The tab’s content is organized into the following subsections: Details, Pages, Categorization, Site URL, Documents and Media, Open Graph, Asset Auto Tagging, Sharing, and Custom Fields.

Details

Site ID: A unique number automatically generated for a Site at its creation. This ID is permanent and cannot be changed.

Name: Set a Site’s title using the Name field. This title is displayed in the browser’s title bar as well as the header for each Site page. You can also localize a Site’s name via the Language Flag button.

Description: Use the Description field to explain a Site’s purpose. You can also localize a Site’s description via the Language Flag button.

Active: Determine whether a Site is Active or Inactive. While inactive, a site is inaccessible to users, though it can be reactivated if desired.

Membership Type: A Membership Type determines how restrictive a Site’s membership is. See Changing Site Membership Types for more information.

Allow Manual Membership Management: Determine whether to allow members to be manually added or removed from a Site. If your Site’s membership is handled automatically by a membership policy, you can disable this setting. See Managing Membership Policies for Sites for more information.

Parent Site: Designate a Site as a child Site by selecting its parent Site. See Site Hierarchies for more information.

Limit Membership to Parent Site Members: Determine whether a child Site’s membership is limited to members of its parent Site. This option only appears for child Sites.

Pages

View a Site’s Public and Private Pages, if any exist, and enable or disable the propagation of changes from the selected Site template. If they don’t exist, a Site Templates selector appears for creating pages with a template.

In the Pages section, you can view a Site's Public and Private Pages.

Custom Fields

View and configure any custom fields you’ve defined for your pages. With these fields, you can set page metadata, such as author, date of creation, and geolocation. This section only appears once you’ve configured custom fields for your Site. See Custom Fields for more information.

Categorization

Use Categories and Tags to categorize a Site’s content so users can more easily find it. For more information on using tags and categories, see Organizing Content with Tags and Categories.

Site URL

Friendly URL: Set a custom URL for both public and private Site pages. See Configuring Your Site’s Friendly URL for more information.

Public and Private Virtual Host: Set public and private Virtual Hosts to map to a Site’s Public and Private Pages. See Configuring Virtual Hosts Site URLs for more information.

In the Site URL section, you can configure your Site's Friendly URL, as well as Virtual Hosts for your Public and Private Pages.

Documents and Media

Determine whether to enable Directory Indexing for a Site. When enabled, a User with view permission can browse the Site’s document library files and folders.

Site Template

If you created your Site using a Site Template, it’s displayed here, along with whether the template allows Users to modify pages that inherit it. See Building Sites from Templates for more information about Site templates and how to create your own.

View your page's selected template.

Open Graph

Enable Open Graph: Determine whether to embed Open Graph <meta> tags in the <head> of your Site’s pages. These tags define page metadata to create engaging representations of your Site’s content when shared in applications that support the Open Graph protocol, such as Facebook, Slack, and Twitter.

Image: Use the Image field to define the following Open Graph <meta> properties for a page:

   <meta property="og:image" content="http://example.com/ogp.jpg" />
   <meta property="og:image:secure_url" content="https://secure.example.com/ogp.jpg" />
   <meta property="og:image:type" content="image/jpeg" />
   <meta property="og:image:width" content="400" />
   <meta property="og:image:height" content="300" />

Image Alt Description: Use the Image Alt Description field to define the og:image:alt property for a page. You can also localize an image’s alt description via the Language Flag button.

See Configuring Open Graph to learn more.

You can enable or disable Open Graph, define image meta tags, and see an image preview.

Sharing

Determine whether to enable document sharing between Site Users. When enabled, Users can share items with one another. See Sharing Documents with Other Users for more information.

Asset Auto Tagging

Determine whether to enable asset auto tagging for a Site. When enabled, assets are auto tagged by the providers configured at Instance scope. See Asset Auto Tagging for more information.

Social

Here you can manage the social interactions between Users on a Site.

Ratings

Here you can select the type of ratings used for the following Site applications: Comments, Knowledge Base, Blogs, Wiki, Message Boards, Web Content, and Documents and Media. See Configuring Content Ratings Types for more information.

You can select the type of ratings used for Site applications.

Mentions

Determine whether to allow Users to mention other Users in Site applications. See Mentioning Users for more information.

Language

Here you can choose whether to use the installation’s default language options, or define your own for a Site.

You can update language options through the Languages tab of Site Settings.

Advanced

Here you can configure additional settings, including analytics services, content sharing, and more.

Default User Associations

Select the Roles and Teams that new Site members are assigned to by default. See Configuring Role and Team Defaults for Site Members for more information.

You can select the Roles and Teams that new Site members are assigned to by default.

Analytics

Use the provided fields to set a Site’s Google Analytics ID and configure additional Google Analytics options. You can also set the Piwik Analytics tracking code for a Site by entering the full script code, including script start and end tags.

If you require a different analytics service, you can add it. See Adding a New Analytics Service for more information and how to add additional fields for different analytics services.

In the Analytics section, you can configure a Site's analytic services.

Maps

Select which maps API provider to use when displaying geolocalized assets in your Site. Geolocalized assets can be displayed for documents, web content articles, DDL records, and more. See Geolocating Assets for more information.

You can select the maps API provider used for Site geolocation.

Recycle Bin

Determine whether to enable the Recycle Bin for a Site. You can specify the number of minutes an asset remains in the Recycle Bin before being automatically deleted. By default, the max age for recycled items is 43200 minutes (i.e., 30 days). See Configuring the Asset Recycle Bin for Sites for more information.

You can configure a Site's Recycle Bin.

Content Sharing

Determine whether child Sites can display content from this Site, including structures, templates, categories, widget templates, and more. Disabling this option immediately revokes content sharing from all child Sites. See Managing Content Sharing Across Sites for more information.

You can determine whether child Sites can display content from this Site.