How to configure the basic settings and general behaviour of Litium.

Account settings, security and Active Directory

The control panel








Command timeouts

Account settings, security and Active Directory

Account settings

General settings for users in Litium.

Section: litium / foundation / accountsettings

  • AccountType: Set account type to be used for users. Allowed values: "INTERNAL" / "AD". AD should only be used if AD users are involved.
  • EnableSessionTimeoutsInGUI: Standard IIS settings allow a user to be inactive for 20 minutes before the session timeouts. By setting false you will not be logged out even if you are inactive for more than 20 minutes.

System user

All settings for the system user.

Section: litium / foundation / accountsettings / systemUser

  • enabled: If the user can log in to Litium Studio with Windows credentials from a remote site (login is always enabled when browsing the site from localhost), only members of the local group Administrators can log in. To change group to not use local Administratos, see the systemUserGroup attribute.
  • useSecureConnectionRedirection: If the system should try to redirect the administrator to use https instead of http.
  • systemUserGroup: Change group to another group than the local Administrators group. Set the name or the SID of the group name according to the pattern "[computername]\[Groupname]" as the value. To allow the local group LitiumStudio to access administrations, the value computer\LitiumStudio should be set, where computer is your local computer name. If any built-in group should be used, the computer should be replaced with builtin.

    The group can also be changed per server by adding the registry key HKEY_LOCAL_MACHINE\SOFTWARE\Litium\LitiumStudio\SystemUserGroup as DWORD with the value of the SID or the group.

To use the system account, log in using an account with admin privileges on the local machine or domain.

Password policy

Define the password policy, used for all users in Litium.

Section: litium / foundation / accountsettings / passwordPolicy

  • LockoutCount: The number of incorrect password attempts allowed before the account is locked. -1 is unlimited.
  • LockoutSeconds: The number seconds the account should be locked when LockoutCount has been exceeded.
  • ExpirePeriodInDays: The number of days the user password will be valid. -1 is unlimited.
  • ComplexityRule: If set to true the password needs to contain at least one character of each of the following types, non-letter or digits, digits, lowercase letter, uppercase letter.
  • LengthRule: If set to true the password must contain at least 6 characters.


Add a directory element for each domain used in the solution.

Section: litium / foundation / accountsettings / directorySettings / directory

  • Domain: Domain to be used.
  • Server: Full name of the sync server.
  • User: The account name of the sync user to use.
  • Password: The account password of the sync user to use.

The control panel

This section describes how to add custom pages into System Settings.

Section: litium / foundation / controlPanelPages / System settings

Add a controlPanelPage element for each page that you want to include in System Settings.

  • Page: The URL to the page. The path starts from /LitiumStudio/Foundation/.
  • Icon: The path to the icon that will be used for the page.
  • SystemStringKey: The key for the value that should be used as the page name. Language dependent.
  • Permission: Defines the kind of permission that users need to have in order to access the page.


This section describes how to add scheduled tasks or start up tasks.

Section: litium / foundation / taskSettings

Scheduled task

Section: litium / foundation / taskSettings / scheduledTasks

Add a scheduledTask element for each task you want to execute in a specific time range.

  • Type: Full name and assembly of the class to run.
  • Start time: The time when the task should be started. If the task should run more than once per day, the first possible occurance will be found based on Interval.
  • Interval: Periodicity. Can be D, H, M, e.g. 2d (every second day), 30M (every 30 minutes).
  • Parameters: Parameters sent to the task, optional.
  • allowOn: "computer:sitename,computer:sitename" - optional. Wildcards (*) can be used for both "computer:sitename" to match all.

Startup task

Section: litium / foundation / taskSettings / startupTasks

Add a startupTask element for each task you want to execute during solution startup.

  • Type: Full name and assembly of the class to run.
  • Parameters: Parameters sent to the task, optional.
  • allowOn: "computer:sitename,computer:sitename" - optional. Wildcards (*) can be used for both "computer:sitename" to match all.


This section describes the files directory, SMTP server and startup information.

Section: litium / foundation / general

Files directory

Section: litium / foundation / general / filesDirectory

  • Value: Upload folder where files are stored.

Common files directory

Section: litium / foundation / general / commonFilesDirectory

When using multiserver environments the commonFilesDirectory should be set in web.config.
This directory is used to store all the information that is common between the servers.

If this tag is not present, a folder named Storage within the folder set in filesDirectory will be used.

  • Value: Upload folder where files that are common to all servers are stored.

SMTP server

Section: litium / foundation / general / smtpServer

  • Value: SMTP server to use inside Litium Studio.


Section: litium / foundation / general / startupInformation

Define a page that should be displayed if Litium Studio has been restarted.

  • Page: Startup information page. If empty, the default is used. Example: value="~/LinkToMyPage.aspx.
  • AutoRedirect: Automatic redirect after xx seconds. -1 = no automatic redirection, 0 = direct redirection.

EventLog settings

Section: litium / foundation / general / eventLog

If you would like to configure the settings for how the event log is treated, you need to make the following addition to the Web.Config file:



	   <eventLog maxAgeInMinutes="60" deleteIntervalInMinutes="60" pollingIntervalInSeconds="5"/>

MaxAgeInMinutes = the maximum number of minutes for values retained in the EventLog.

Note: If the value is set too high the startup might be slower, due to reading of old events.

DeleteInterval = the interval for deleting old values from the EventLog.

Note: A low value shortens the event log but also increases the number of queries sent to the database.

PollingInterval = the interval for checking the EventLog for new events raised at other servers.

Note: A low value increases the number of queries sent to the database. In a single server setup there is no need to change this value.


Search settings for the current solution of Litium.

Section: litium / foundation / search

  • enableChangeTracking: If set to true, then search indexes will be synchronised with the underlying repository, by listening to events raised on data changes. This will affect the performance slightly. If false, indexes will not be updated until you manually update it. That is commonly used when performing larger import jobs, and it is often combined with a scheduled task that updates the indexes during the night.
  • backOfficeFuzzySearchSimilarity: Fuzzy search similarity for backoffice.
  • publicSiteFuzzySearchSimilarity: Fuzzy search similarity for public site.


Settings for Websites area.

Section: litium / studio / cms

  • enableGoogleSite: If set to true, it is possible to access the Google SiteMap XML.
  • useSecureConnection: Determines if secure connection checks should be enabled.
  • cacheSlidingTimeInSeconds and cacheAbsoluteTimeInSeconds: Determines for how long the cache should hold objects.


Settings for handling URL routing in Websites. Add a disabledRoutingPath element for each route you want to disable. Read more about URL routing and configuration.

Section: litium / studio / cms / routing.

  • Path: the path to be disabled, relative to the root.


Settings for the Products area.

Section: litium / studio / productCatalog

  • enablePriceAgent: If set to true, it is possible to access the Price Agents XML.


Settings for the Sales area.

Section: litium / studio / ecommerce

  • orderExportXslt: If an XSLT file is specified here, it will be used to transform the exported orders in the Order Export feature. The user will only get the transformed XML file. The XSLT file should reside in the /Bin directory.
  • gateWayIP: If the web server is behind a firewall with port forwarding, this needs to be set to the visible public IP (example: ""). Used for communication with providers.



Settings for the storage handler.

Section: litium / studio / storage

  • useCdn: Determines if CDN support is enabled.
  • useSecureCdn: Determines if CDN should be enabled on secured pages (SSL).
  • cdnHost: Hostname for the CDN network.
  • cdnSecureHost: Hostname for the CDN network when browsing over SSL.

Command timeouts

This section describes how to change the SQL time out settings for specific SQL stored procedures.

Add a commandTimeOut element per stored procedure.

Section: litium / commandTimeouts

  • Command: The name of the stored procedure.
  • Timeout: Time in seconds.