Configure site settings for websites

A site setting is a configurable, named value that is used by website code to modify the behavior or visual style of the site. Typically when a developer creates the website code, they reference site settings for various components to enable an end user to modify the setting values to alter the website without having to change the code, recompile, and redeploy the website.

The sample websites and templates that are provided with the installation of Power Pages contain several configurable site settings for various styles used to modify many visual elements within the site such as background style, text color, and layout width. You can manage the following types of site settings:

  • Global settings: These settings apply to all websites associated with the Microsoft Dataverse environment in which they're being added.
  • Website site settings: These settings apply to specific websites that are associated with the Dataverse environment in which they're being added.

Manage site settings

  1. Using the Portal Management app, select Site settings under the Website section.

  2. To create a new setting, select New.

  3. To edit an existing setting, select the Site Setting listed in the grid.

  4. Specify values for the fields provided:

    • Name: A label referenced by website code to retrieve the appropriate setting. The name should be unique for the associated website, because the code retrieving the setting takes the first record found with the matching name.

    • Website: The associated website.

    • Value: The setting

    • Description: The purpose of the setting or special instructions.

  5. Select Save & Close.

Note

Bing Maps integration is not supported in the German Sovereign Cloud. If you try to create the Bingmaps/credentials setting in this environment, an error message will be displayed.

Site settings

Name Value Description
Authentication/Registration/RequiresConfirmation FALSE A boolean value of true enables email confirmation and disables open registration. Default: False
Authentication/Registration/RequiresInvitation FALSE A boolean value of true enables invitation code feature and disables open registration. Default: False
HelpDesk/CaseEntitlementEnabled TRUE A Boolean value indicating if the Help Desk Case Entitlement is enabled. Default: false
HelpDesk/Deflection/DefaultSelectedProductName The name of a product record that is the default selected product in dropdown displayed on the Help Desk Case Deflection if there are more than one product where the producttypecode equals 100000001.
Profile/ForceSignUp FALSE A Boolean value when set to "True" forces the user to update their profile information before they have access to the website contents. Default: False
Profile/ShowMarketingOptionsPanel TRUE A Boolean value that indicates whether to show the panel that lists the fields to specify the marketing communication preferences on the profile. Default: False
Search/Enabled TRUE A Boolean value that indicates if search is enabled or not.
search/filters Content:adx_webpage;Events:adx_event,adx_eventschedule;
Blogs:adx_blog,adx_blogpost,adx_blogpostcomment;
Forums:adx_communityforum,adx_communityforumthread,adx_communityforumpost;
Ideas:adx_ideaforum,adx_idea,adx_ideacomment;
Issues:adx_issueforum,adx_issue,adx_issuecomment;Help Desk:incident
A collection of search logical name filter options. Defining a value here adds dropdown filter options to site-wide search. This value should be in the form of name/value pairs, with name and value separated by a colon, and pairs separated by a semicolon.
For example: "Forums:adx_communityforum,adx_communityforumthread,adx_communityforumpost;Blogs:adx_blog,adx_blogpost,adx_blogpostcomment".
Search/IndexQueryName Portal Search The name of the system view used by the website search query. Default: Portal Search
search/query +(@Query) _title:(@Query) _logicalname:adx_webpage~0.9^0.2
-_logicalname:adx_webfile~0.9 adx_partialurl:(@Query)
_logicalname:adx_blogpost~0.9^0.1 -_logicalname:adx_communityforumthread~0.9
Override query for site search, to apply other weights and filters. @Query is the query text entered by a user. Lucene query syntax reference: https://lucene.apache.org/core/old_versioned_docs/versions/2_9_1/queryparsersyntax.html
Search/Stemmer English The language used by the website search's stemming algorithm. Default: English
CustomerSupport/DisplayAllUserActivitiesOnTimeline FALSE
Authentication/[Protocol]/[Provider]/AllowContactMappingWithEmail Allow automatic association to a contact record based on email.
More information: Allow contact mapping with email and require unique email general options.
Authentication/[Protocol]/[Provider]/AllowContactMappingWithEmail isn't applicable for multitenant endpoints. Use invitations to allow users to authenticate to your website.
Site/EnableDefaultHtmlEncoding True/False Power Pages release version 9.3.8.x or later by default have escape Liquid filter enforced for user and request Liquid objects. To disable this default configuration and allow these Liquid objects without escape Liquid filter, add this setting and set its value to False.
EnhancedFileUpload True/False Starting with Power Pages release version 9.3.2405.xx, new sites are automatically enabled with the enhanced file upload feature. To opt in for existing websites, add this setting and set its value to True. Learn more in Enable attachments on a form.

Note

Authentication/[Protocol]/[Provider]/AllowContactMappingWithEmail is not applicable for multi-tenant endpoints and Microsoft identity provider. Use invitations to allow users to authenticate to your website.

For site settings related to various website features, see:

Manage global settings

  1. Open the Portal Management app.

  2. Go to the Website section and select Settings.

  3. To create a new setting, select New.

  4. To edit an existing setting, select the Setting listed in the grid.

  5. Specify values for the fields provided:

    • Name: A unique name referenced by code to retrieve the appropriate setting.

    • Value: The setting

    • Description: The purpose of the setting or special instructions.

  6. Select Save & Close.