November Happy Hour will be moved to Thursday December 5th.

AI OnAI Off

Home / Documentation / EPiServer CMS 6 R2 /

Configuration - <episerver> Section

Product version:	EPiServer CMS 6 R2
Document version:	1.0
Document last saved:

Section Hierarchy - Table of Contents

This is a pseudocode description of the element structure of the episerver section. Each element name is also a link leading to the detailed information for that element

<episerver>
   <dynamicContent>
   <imageEditor>
   <linkValidator>
   <pageProvider>
   <sites>
   <tinyMCE>
   <urlRewrite>
   <virtualPathMappings>
   <visitorGroup>
   <workflowSettings>
</episerver>

<dynamicContent>

<dynamicContent> <controls> <add description="string" name="string" type="string" /> ... </controls> </dynamicContent>

<add> Element Attributes

Name	Default Value	Description
description		A longer descriptive text that will be presented to the editor.
name		A short descriptive name used to identify the dynamic content control.
type		The full classname of the dynamic content control.

<imageEditor>

<imageEditor enabled="bool" modifiedImagesTargetVirtualPath="string" windowHeight="int" windowWidth="int" zoomImageToFitInWindow="bool"> <sizePresets> <preset height="int" name="string" languageKey="string" width="int" /> ... </sizePresets> </imageEditor>

<imageEditor> Element Attributes

Name	Default Value	Description
enabled	true	Indicates if the image editor is used in edit mode.
modifiedImagesTargetVirtualPath	String.Empty	The virtual path to the location where images modified in the image editor are saved. If no value is set (as by default) the page folder for the current page is used.
windowHeight	600	The preferred height and width of the image editor. This is the final fallback, settings on the property level have precedence.
windowWidth	900
zoomImageToFitInWindow	false	If set to true images will be zoomed to fit the image editor window when opened.

<preset> Element Attributes

Name	Default Value	Description
height		The image preset height in pixels.
name		Name for to be shown in the preset selection list. If not specified the name shown will be "width x height"
languageKey		A language key to where localized name strings can be found.
width		The image preset width in pixels.

<linkValidator>

<linkValidator> Element Attributes

Name	Default Value	Description
externalLinkErrorThreshold	100	The threshold for the number of consecutive errors that need to occur before the job stops.
internalLinkValidation	ValidationType.Api	How the link validator will validate internal links. The ValidationType enum has three possible values: Off : Do not validate internal links. Api : Validate by API, i.e. call GetPage for the referenced page and verify that the page exists. Does not detect errors that occur in page template code. Request : Validate by HTTP request. This method is the most thorough as it simulates clicking the link. Detects errors that occur in page template code.
maximumRunTime		The maximum time the job will run at one time.
proxyAddress		Optional web proxy address for the link checker to use when validating links.
proxyDomain		Optional web proxy domain to authenticate the proxy connection.
proxyPassword		Optional web proxy password to authenticate the proxy connection.
proxyUser		Optional web proxy user for to authenticate proxy connection.
recheckInterval	7.00:00	The time that must elaps before a link is rechecked.
userAgent	EPiServer Link Checker	The user agent string to use when checking validity of links.

<add> Element Attributes

Name	Default Value	Description
regex		A regular expression matching a link that should be ignored by the link validation.

<pageProvider>

<pageProvider> <providers> <add capabilities="EPiServer.Core.PageProviderCapabilities" entryPoint="int" iconPath="string" name="string" pageFolderVirtualPathProvider="string" supportedVirtualPathProvider="string" type="string" wastebasketName="string /> ... </providers> </pageProvider>

<add> Element Attributes

Name	Default Value	Description
capabilities	PageProviderCapabilities.None	The capabilites that are supported by this page provider. PageProviderCapabilities is a Flags enum, meaning that you can combine any number of values. Please refer to the SDK documentation for more detailed information about the possible values.
entryPoint		The ID of the page that will act as a container for the pages delivered from this page provider.
iconPath		The path to an icon image file. The icon will be shown in page tree to distinguish pages served by this page provider instance. The path given should be relative the theme folder "App_Themes/Default/Images/ExplorerTree/PageTree/".
name		A short descriptive name used to identify the page provider. If you set name to "default" that page provider will replace the LocalPageProvider as the default page provider.
pageFolderVirtualPathProvider		The name of the virtual path provider that should be used for page folders for this page provider.
supportedVirtualPathProvider		A comma separated list of virtual path provider names. Only files contained within the listed virtual path providers can be referenced from pages hosted by this page provider.
type		The full classname of the page provder class.
wastebasketName		The name of the wastebasket for this provider instance. If this attribute is not present the name will be equal to the value of the name attribute.

<sites>

<site> Element Attributes

Name	Default Value	Description
applicationId		Legacy attribute, not used by the system.
description		A text that describes the site instance. This attribute is only for making it easier for you to find the correct element, the value is not used by the application.
licenseFilePath		The path to the configuration file used by this site instance. If no value is set the license file is assumed to be located in the root folder of the application.
siteId		A unique ID for this site instance. This ID is used in the host mappings section in EPiServerFramework.config.

<guide> Element Attributes

Name	Default Value	Description
destinationPageId		The parent page of the page created by the guide.
name		Name of the page guide.
pageTypeName		The type of page that will be created.
title		Title of the page guide.

<property> Element Attributes

Name	Default Value	Description
propertyName		The name of the property that should be edittable in the page guide.

<siteSettings> Element Attributes

Name	Default Value	Description
autoSaveInterval	0:1:0	The auto save interval. If the value is less than 10 seconds, the auto save feature will be turned off.
backgroundCopyThreshold	50	The threshold value for the maximum number of pages that can be copied in the current thread. If a copy operation is requested with a larger number of pages than the threshold the copy operation is performed in a background thread.
(categoryId)		Obsolete legacy attribute. The attribute is allowed but the value is not used.
connectionStringName	EPiServerDB	The identifying name for the connection string that should be used by EPiServer CMS. A connection string with the specified name must exist in connectionStrings.config.
databaseQueryTimeout	0:0:30	The query timeout value that is used for all database requests.
deadlockRetries	5	The number of retry attempts when a database deadlock occurs.
deadlockRetryDelay	0:0:0.1	The time between repeated requests if a database deadlock occurs.
disableVersionDeletion	false	Defines if the UI should disable tools that allow page and file versions to be deleted.
draftRetainPeriod	3.0:0:0	The retain period for drafts created by the autosave functionality.
(enableEvents)		Obsolete legacy attribute. The attribute is allowed but the value is not used. The event system is now located in EPiServer Framework.
(enableRemoteEvents)		Obsolete legacy attribute. The attribute is allowed but the value is not used. The event system is now located in EPiServer Framework.
enableScheduler	true	Set to false to disable this application's connection to the scheduler service. This setting is typically used in a load balanced scenario when you want to make sure that scheduled jobs are only run on a specific machine.
enableXmlRpcHeader	false	Defines whether XML-RPC headers should be added to page output. By including XML-RPC headers in the output you allow the use of blog applications supporting the XML-RPC protocol.
errorMailHandler	~/Util/SendErrorReport.aspx	An address to which the error form data will be posted. Only used if EPiServer CMS error handling is triggered (globalErrorHandling is On or RemoteOnly). The default address points to a web form that will send and error report mail to address specified in the globalErrorMail attribute.
globalErrorHandling	RemoteOnly	Set whether to use EPiServer CMS error handling. There are three possible values : On \| Off \| RemoteOnly. On : EPiServer CMS hides the original error and a generic error message is displayed instead. The form loaded via the errorMailHandler (above) setting is shown to allow the visitor to report the error. Off : Errors are not handled by EPiServer CMS. Errors will be handled by ASP.NET as defined in the customErrors element. RemoteOnly : Error handling is On for all visitors except for those accessing the site from the web server itself.
globalErrorMail		E-mail address that error messages should be sent to.
googleMapsApiV3Url	http://maps.google.com/maps/api/js?v=3.1&sensor=false	The URL for Google Maps API v3, possibly site-specific.
httpCacheability	HttpCacheability.Server	The HttpCacheability enum for the Cache-Control HTTP header.
httpCacheExpiration	0:0:0	The amount of time that a page should be cached in the outputcache, this value will be set in the http request policy. It will activate both client side caching and server caching outputcache. Policy will only apply to anonymous users and when http request method is GET. The cache will automatically be updated when changes are made to a page in EPiServer CMS.
httpVaryByCustom	browser	Specifies a custom text string to vary cached output responses by. Passed to Response.Cache.SetVaryByCustom.
httpVaryByParams	id	The parameters to the page (i.e. querystring) that the cache should vary by. Forwarded to Response.Cache.SetVaryByParams.
IISHiddenSegments	bin, app_code, app_globalresources, app_localresources, app_webreferences, app_data, app_browsers	Defines IIS' hidden segments in comma separated format.
indexingDelayAfterPublish	0:0:20	Delay time between publish and indexing.
indexingTextEnabled	true	Defines if indexing of text into keywords should be enabled. Can be set to false if you use an external search engine instead of the built it EPIServer CMS functionality.
indexingTextRegExp	[\p{N}\p{L}]{1}[\p{N}\p{L}-\._]*[\p{N}\p{L}]{1}	The regular expression used to index words in pages.
logServiceUrl	soap.tcp://localhost/TimeSpanAnalyzerView	URL to the log service.
mirroringFileWriteDelay	0:0:5	Setting for the EPiServer CMS 5 version of mirroring which by default is not enabled when you install an EPiServer CMS 6 site. Delay time between retrying to transmit mirroring files.
mirroringHtmlTextEncoding	String.Empty	Setting for the EPiServer CMS 5 version of mirroring which by default is not enabled when you install an EPiServer CMS 6 site. Sets which encoding should be used when mirroring to HTML.
mirroringMonitoringMaxDataPerJob	1000	The maximum number of monitoring data messages that are kept during a mirroring session. For example, if mirroringMonitoringMaxDataPerJob is set to 100 and the 101st monitoring data messsage is recieved, the oldest/first message will be pushed out of the log.
mirroringRetries	5	Setting for the EPiServer CMS 5 version of mirroring which by default is not enabled when you install an EPiServer CMS 6 site. Number of retries when a mirroring job fails.
mirroringRetryDelay	0:0:1	Setting for the EPiServer CMS 5 version of mirroring which by default is not enabled when you install an EPiServer CMS 6 site. The time delay between mirroring retries.
mirroringSource	mirroringSourceEndpoint	The name endpoint to use when communicating with the mirroring service. A client endpoint with the specified name must be registered in the <system.serviceModel> element in web.config.
operationCompatibility	EPiServerCompatibility.None	A set of EPiServerCompatibilty flags that define the behaviour of the DataFactory.Save and Delete methods. None : There is no Compatibility at all PageStoreSave : The Save operation on DataFactory Component can treat as old version of DataFactory PageStoreDelete : The Delete operation on DataFactory Component can treat as old version of DataFactory Full : Both Save and Delete operation on DataFactory component treat as old version This setting can be used if your project contains code that was written to fit the older (EPiServer CMS 5 R1 or earlier) behaviour of the Save and Delete methods.
pageCacheSlidingExpieration	12:0:0	The page cache for the local database.
pageFolderVirtualPathProvider	EPiServerPageDirectory	Name for the VirtualPathProvider that is responsible for handling of page folders. The provider collection in the virtualPath element must contain a provider with the specified name.
pageOfficeStartId	0	Defines from where the Office plug-in should display the site tree.
pageRootId	1	ID of the root page. Can not reference a page delivered from a page provider.
pageStartId	0	ID of the page that serves as the start page for the site. Can not reference a page delivered from a page provider.
pageUseBrowserLanguagePreferences	false	Determines if the browser language should define which language is used.
pageValidatePageTemplate	true	Defines if the current template has to match the page type template.
pageWastebasketId	2	ID of the recycle bin. Can not reference a page delivered from a page provider.
permanentEditRetainPeriod	30.0:0:0	The amount of time that a page's permanent edit status should be retained. The permanent edit status will be cleared by the Remove Permanent Editing scheduled job if the status has been active longer than the time span specified in permanentEditRetainPeriod.
remoteCacheListenerShortNames	String.Empty	A comma separated list of remote sites that will recieve notifications when a change is made.
remotePageCacheSlidingExpiration	2:0:0	The page cache for remote sites.
remoteWebServiceCulture	0	The culture to be used when communicating with a remote web service.
sgmlParserDecodeCharEntities	false	Defines whether SgmlParser should decode character entitities (like " ") or not.
siteDisplayName	EPiServer Site	The name of the site.
(siteShortName)		Obsolete legacy attribute. The attribute is allowed but the value is not used. Use the siteId attribute on the parent <site> element instead.
siteUrl	http://localhost/	The site URL. It must be a Web URL, and include the path to the site root. It is only to be used to generate direct references to the site in external locations.
stringCompressionThreshold	0	The threshold value for the number of characters required in properties deriving from PropertyLongString to enable compression. A value of 0 turns string compression off.
stringDelayedLoadThreshold	0	The threshold value for the number of characters required in properties deriving from PropertyLongString to enable delayed loading of the property value. A value of 0 turns delayed loading off.
subscriptionHandler	EPiServer.Personalization.SubscriptionMail, EPiServer	Full class name to the class that should handle subscription mail. The class must implement ISubscriptionHandler.
uiDefaultPanelTab	0	The index of the EditPanel tab that is to be shown by default when clicking a page in the editmode pagetree. The value of this property is used as an zero-based index in an array of EditPanel tabs. For example, all pages in a default installation of the example will have the following tabs: View : 0 Edit : 1 Version list : 2
uiEditorColors	String.Empty	This setting only applies to the EPiServer CMS 5 editor. A comma separated list of colors that should be available for the editors. Example: uiEditorColors="White=FFFFF,Black=000000"
uiEditorHeight	250	The default height of the editor in edit mode.
uiEditorUnformattingPersistedTags	p\|div\|br\|ul\|li\|ol	Pipe separated list of html tags that should not be preserved in "Remove format" action in editor.
uiEditorValueOptions	0	A combination of EditorValueOption flags that control how the editor handles some aspects of the HTML code generation.
uiEditorWidth	500	The default width of the editor in edit mode.
uiImageTransparencyReplacement	White	The color that should replace the transparent color in a picture compression.
uiKeepUserLoggedOn	true	Sets if the current windows authenticated user must reauthenticate after session timeout.
uiMaxVersions	0 (unlimited)	The maximum number of page versions that EPiServer will retain.
uiOptimizeTreeForSpeed	false	Defines if page tree controls should evaluate if tree nodes have children. If set to false, tree controls will not evaluate if a node has children when it becomes visible. Only nodes that have children will display an expand icon ([+]), i.e. [+]NodeName. If set to true, tree controls will not evaluate if a node has children when it becomes visible. Thus all nodes will display an expand icon, regardless of if it has children or not. This behaviour will increase performace when displaying large tree structures.
uiSafeHtmlTags	b,i,u,br	Defines which tags should not be encoded.
uiShowGlobalizationUserInterface	false	Defines if the globalization tools should be available in the UI.
uiTheme	String.Empty	Setting for what graphical theme should be used. The value must correspond to a name of a subfolder in the App_Themes folder. The Default theme is used if no other value is specified.
uiUrl	~/UI/	The URL to the relocateable UI folder. It must be a Web URL, and may include scheme and port.
uiVersionMerging	true	Defines if information on a page should be merged if it has been published while being edited.
UrlPreventRewriteAttribute	EPiNoRewrite	This setting only applies to the EPiServer CMS 5 editor. For internal use, do not use. Defines the HTML attribute name that is used by the CMS 5 legacy editor when writing / parsing content.
urlRebaseKind	Default	Defines the type of rebasing to do for links when using Friendly URLs. Possible values are any combination of EPiServer.UrlBuild.RebaseKind flags.
urlRewriteExtension	String.Empty	Defines an extension that is mapped to ASP.NET for the URL. During the url rewrite step, before a HTTP response is sent to the client, the urlRewriteExtension value will be added as a suffix to all links that points to pages on the site. Likewise, during the url rewrite step at the beginning of a request, the suffix is removed.
utilUrl	~/Util/	The URL to the relocateable Util folder. It must be a Web URL, and may include scheme and port.
(wcfConfigFilePath)	String.Empty	Obsolete legacy attribute. The attribute is allowed but the value is not used. Create a file with the name {siteid}_web.config where siteid is the id of the site.

<tinyMCE>

<tinyMCE mergedConfigurationProperties="string" />

<tinyMCE> Element Attributes

Name	Default Value	Description
mergedConfigurationProperties	valid_elements, extended_valid_elements, invalid_elements, valid_child_elements	Properties that will be mergable for plugins in TinyMCE. If several TinyMCE plugis set different values for any of the configuration options listed in this attribute these values will be merged.

Name

Default Value

Description

mergedConfigurationProperties

valid_elements, extended_valid_elements, invalid_elements, valid_child_elements

Properties that will be mergable for plugins in TinyMCE.

If several TinyMCE plugis set different values for any of the configuration options listed in this attribute these values will be merged.

<urlRewrite>

<urlRewrite defaultProvider="string" > <providers> <add name="string" type="string" /> ... </providers> </urlRewrite>

<add> Element Attributes

Name	Default Value	Description
name		A short descriptive name used to identify the url rewrite provider.
type		The full classname of the url rewrite provider.

<virtualPath>

<virtualPath customFileSummary="string" illegalCharactersDisplayString="string" illegalCharactersRegex="string" > <filters> <add name="string" providerName="string" type="string" /> ... </filters> <providers> <add name="string" type="string" /> ... </providers> </virtualPath>

<virtualPath> Element Attributes

Name	Default Value	Description
customFileSummary		The path to a XForm describing the metadata that is attached to each file in the virtual path providers.
illegalCharactersDisplayString	%,&,+,COM[0-9],LPT[0-9],PRN,CLOCK$,AUX,CON,NUL,*.	Characters that are illegal in a file or directory name. The value is used to inform users which characters that are not allowed in file or directory names. The regex defined in illegalCharactersRegex is used to detect illegal characters.
illegalCharactersRegex	%\|&\|\+\|/COM[0-9]([/\.]\|$)\|/LPT[0-9]([/\.]\|$)\|/PRN([/\.]\|$)\|/CLOCK\$([/\.]\|$)\|/AUX([/\.]\|$)\|/NUL([/\.]\|$)\|/CON([/\.]\|$)\|/.+\.$\|\.\.	A regex that is used to detect illegal characters in a file or directory name. If illegal characters are found the string defined in illegalCharactersDisplayString is presented to the user in an error message.

Name

Default Value

Description

customFileSummary

The path to a XForm describing the metadata that is attached to each file in the virtual path providers.

illegalCharactersDisplayString

%,&,+,COM[0-9],LPT[0-9],PRN,CLOCK$,AUX,CON,NUL,*.

Characters that are illegal in a file or directory name.

The value is used to inform users which characters that are not allowed in file or directory names. The regex defined in illegalCharactersRegex is used to detect illegal characters.

illegalCharactersRegex

%|&|\+|/COM[0-9]([/\.]|$)|/LPT[0-9]([/\.]|$)|/PRN([/\.]|$)|/CLOCK\$([/\.]|$)|/AUX([/\.]|$)|/NUL([/\.]|$)|/CON([/\.]|$)|/.+\.$|\.\.

A regex that is used to detect illegal characters in a file or directory name.

If illegal characters are found the string defined in illegalCharactersDisplayString is presented to the user in an error message.

<filters>/<add> Element Attributes

Name	Default Value	Description
name		A short descriptive name used to identify the filter.
type		The full classname of the url rewrite provider.

<providers>/<add> Element Attributes

Name	Default Value	Description
name		A short descriptive name used to identify the virtual path provider.
type		The full classname of the virtual path provider.

<visitorGroup>

<visitorGroup> <searchKeyWordCriteria pattern="string" /> </visitorGroup>

<searchKeyWordCriteria> Element Attributes

Name	Default Value	Description
pattern	([#?&](amp;)?(q\|p)=(?<query>[^&]+))	Regular expression used by the Search keyword visitor group criterion to extract search keywords from the referrer adress. If you choose to write you own regex to replace the default one, make sure that each keyword is caught by the "?<query>" capture group.

Name

Default Value

Description

pattern

([#?&](amp;)?(q|p)=(?<query>[^&]+))

Regular expression used by the Search keyword visitor group criterion to extract search keywords from the referrer adress.

If you choose to write you own regex to replace the default one, make sure that each keyword is caught by the "?<query>" capture group.

<workflowSettings>

<workFlowSettings> Element Attributes

Name	Default Value	Description
workflowDelayedLoading		Defines if delayed loading should be used. If enabled instances and definitions are not loaded before first access

Name

Default Value

Description

workflowDelayedLoading

Defines if delayed loading should be used.

If enabled instances and definitions are not loaded before first access

<definition> Element Attribute

Name	Default Value	Description
description		A description of the workflow.
name		A short descriptive name used to identify the workflow.
type		The full classname of the workflow.

<externalService> Element Attributes

Name	Default Value	Description
type		The full classname of an external type that is referenced from an external XAML file.

<reference> Element Attributes

Name	Default Value	Description
path		Path to an assembly that is needed by any of the registered workflows. Assemblies registered in the GAC need not be listed here.

Name

Default Value

Description

path

Path to an assembly that is needed by any of the registered workflows.

Assemblies registered in the GAC need not be listed here.

<workflowHost> Element Attributes

Name	Default Value	Description
type	EPiServer.WorkflowFoundation.AspNetWorkflowManager,EPiServer.WorkflowFoundation	Full classname of the host that will host workflow instances. Registered class must implement IWorkflowManager.

Name

Default Value

Description

type

EPiServer.WorkflowFoundation.AspNetWorkflowManager,EPiServer.WorkflowFoundation

Full classname of the host that will host workflow instances.

Registered class must implement IWorkflowManager.