Add-ons


  • MultiSites: If user creates form via Forms gadget from site2, gets redirected to site1
    Description This article describes an issue experienced in the following bug:MultiSites: If user creates form via Forms gadget from site2, gets redirected to site1  Upgrading to the latest version of Episerver Forms did not resolved the issue. Resolution In this case the the Epise...

  • Slow Loading Forms with Marketo Add-on
    Description When the Episerver Connect Marketo add-on you may experience slow load times if there are numerous lists being loaded on a page.  Resolution If you have several hundred or more lists being loaded on a page you may want to disable auto-fill on forms to improve load time...

  • Episerver Pardot AddOn In DXC Not Submitting Form
    Description This article describes an issue with Pardot form submissions in Episerver DXC environment. The underlying error message is the following: Either the user and/or API keys are incorrect, or the API key has expired. For more information on this error and other Pardot errors please ...

  • Destination URL not reset on Salesforce form creation
    Description When attempting to create a Salesforce form within the CMS the the following error message may be thrown. This is may be caused by Salesforce disabling support for TLS1.0 as noted in the following excerpt. Support of TLS 1.2 was not supported for Salesforce until EPiServer.Marke...

  • Episerver Forms localization
    Description This article describes an issue of how to customize the Form control’s text, for example, if you want to change the form step text from "Previous Step" to "Previous Page" and "Next step" to "Next Page".  Resolution Edith the fol...

  • Import Forms submission data automatically
    Description The code snippet below is used to import multiple submission data to form for testing. Resolution var ddsSubmission = new DdsPermanentStorage(); //this guid can be get from html tag is generated in container page //use inspect element tool of browser and click to this...

  • See all 11 articles
  • API


  • Deleting old content versions using the API
    Description Sometimes the episerver configuration attribute uiMaxVersions does not work, it is instead possible to use IContentVersionRepository to delete older content versions.  Resolution The example below is only for one content item. The code could be developed further to loo...

  • Enable special characters in URL Segment
    Description There's a default validation for URL Segment when a page is created which replaces special characters with the normal ones (for example ä becomes “a”). In some cases, clients want to keep those special characters in the URLs for their non-English versions of the web site. ...

  • How to stop a custom job in Admin UI in case your job has a loop.
    Description There are some partner developers followed this article http://world.episerver.com/documentation/developer-guides/CMS/scheduled-jobs/  to stop a job in admin UI. According to this post, a basic scheduled with the possibility to stop a job by overriding Stop method, so this metho...

  • How to get direct link to page in edit mode
    Description This article describes how to get a direct link to a page in edit mode using the Episerver API. This may be useful for developing a custom report. Resolution When looking for a link like the example below http://localhost:17000/Internal/UI/CMS/?language=sv#context=epi....

  • 'System.ArgumentNullException' occurred in Newtonsoft.Json.dll
    Description This article describes a cryptic error that can be thrown from any Episerver API and how to troubleshoot it. The complete error message can be seen below. An exception of type 'System.ArgumentNullException' occurred in Newtonsoft.Json.dll but was not handled in user codeAddition...

  • How to Return JSON for Episerver Form by Sort Order
    Description This article illustrates the code to return the JSON for an Episerver Form by a specified sort order. Resolution The code below can be found in full here. var formIden = new FormIdentity(formGuid, (content as ILocalizable).Language.Name); var friendlyNames = _formReposit...

  • See all 15 articles
  • Authentication


  • Custom login page with Owin Authentication
    Most of the customers always prefer a custom login page to the default one which should only be accessible by WebAdmins and WebEditors users. There was a blog article about this before (Creating a custom login page in Episerver and MVC). The method was described as using the standard SQLMembers...

  • Trouble Accessing Support Tickets
    Description You may experience an issue where you are unable to access the ticketing system to view tickets and attachments, create and update tickets. This article explains how the process works as well as what can be done to correct these types of issues. Resolution While viewin...

  • Owin error on registration
    Description When attempting to register a user or perform an owin authentication action, you may run into the following error. Server Error in '/' Application. No owin.Environment item was found in the context. Description: An unhandled exception occurred during the execution of the curren...

  • Issue Mixing Active Directory Membership Provider With SQL Role Provider
    Description This article describes the out of the box limitation in mixing Active Directory membership providers with SQL role provider. Resolution Product Development Engineering has reviewed this use case and provided information.   After the review they clarified that "Act...

  • Creating a new user group to allow logins
    Description If you create a new group in Episerver, for example an Editors group because you do not want them to have Publishing permissions like other groups may have, you may run into the issue where members of that group can not log in.  This is because you need you authorize logins for ...

  • LDAP query limitation
      When importing users or user groups into the CMS not all users or user groups are getting pulled into the CMS. Cause There is a LDAP limitation as a query typically limits queries to 1000 for both users and directories. This can cause the CMS to only import portions of the total AD...

  • See all 8 articles
  • Browser


  • IE11 switches to IE5 document mode and causes rendering issues in CMS 6 R2 edit mode)
    Description If you use IE 11 to browse to Edit Mode of a CMS 6 R2 site, you may notice that edit mode preview is broken. Using F12 to get to Developer Tools, the document mode has switched to IE5 mode. Resolution When the the CMS6 edit UI was created it was done with support for th...

  • Different search results in IE compared to other browsers
    Description Issue: The search results in our site for a query string (for ex:- "title") gives different search results in IE as compared to other browsers (Chrome, Firefox and Edge). When searching for the word "title" 13 results return in IE and 10 in the other browsers...

  • Episerver Forms Triggers "Only Secure Content Is Displayed" Popup
    Description The article describes an issue with a popup that appears on some browsers when using Episerver Forms with an address element. The address element uses Google API to suggest addresses when a user is typing and it automatically fills address components and displays a map when an ad...

  • Commerce


  • How to change the default warehouse
    Description How to change the default warehouse by configuring it in Commerce Manager. Resolution The Stockholm store is the default warehouse in Episerver Commerce and can be changed in Commerce Manager by setting the Is Fulfillment Center field (See screenshot).

  • FindItems returns no results when searching with meta fields
    Description The article describes an issue with CatalogContext.Current.FindItems when searching with multiple meta field conditions in the SqlMetaWhereClause. In addition, if there are CatalogSearchOptions.Classes being used this will also cause issue with results. Here is a sample code tha...

  • How much money each promotion saves
    Description When using the new promotion engine, there is an issue with determining how much money each promotion saves using the PromotionInformation.SavedAmount. However, it seems this amount is compounded in case of multiple promotions.    How do you properly get the amount saved for eac...

  • OrderAddress Metafields are not saved
    Description This article describes and issue with saving Metafields when working with OrderAddress.  When trying to save the payment billing address as follows: IOrderAddress address = GetDefaultBillingAddress(); address.Id = Constants.Order.BillingAddressName; address.Properties["IsVa...

  • Working with Meta Class from Commerce v10
    Description In Commerce v10, Metadata Plus is introduced. This article demonstrates performing CRUD actions with the new MetaClass class (in the Mediachase.MetaDataPlus.Configurator assembly) in Catalog and Order systems.  Resolution //Createvar metaDataContext = CatalogContext.Me...

  • How to make serializable carts work with ICreditCardPayment
    Description This article describes an issue with serialiazable carts missing some payment information. The CreditCard data like CreditCardNumber, CreditCardSecurityCode, ExpirationMonth, ExpirationYear, and BillingAddress are missing when loading the SerializableCart because the Serializabl...

  • See all 16 articles
  • Configuration


  • Issue with Visitor Group Geographic Location criteria
    Description This article describes an issue when using the built-in (Geographic Location) criteria. The editor can see the personalized content in edit mode but not after logged out/when clicking on view on website. Resolution Make sure GeocityLite database is available in App_Dat...

  • DataTime over different timezones.
    Description A customer runs a website which is hosted on Azure. For example West Europe (The Netherlands), this is also where the company is located. Now their question: When they enter a date in the Cms the date on the website is shown with a 2 hour difference. How do you fix the 2 hour di...

  • How to troubleshoot EPiServer.Framework.Initialization.InitializationException
    Description An exception of type 'EPiServer.Framework.Initialization.InitializationException' occurred in EPiServer.Framework.dll but was not handled in user codeAdditional information: Initialize action failed for Initialize on class EPiServer.Data.DataInitialization, EPiServer.Data, Versi...

  • Missing modules or packages when loading Episerver site
    Description If you see the following error see the resolution below Did not find a module by assembly 'EPiServer.GoogleAnalytics, Version=1.10.3.0, Culture=neutral, PublicKeyToken=null'Parameter name: moduleAssembly Resolution Usually when you first build a project it will build t...

  • Seeing other environment URLs under the Cloud Licenses screen
    Description When you navigate to the Cloud License tab of Manage Websites in the administration portal of Episerver you may see URLs that belong to environments you are not currently in (for example QA URLs in Production or Production in QA). Resolution This behavior is expected s...

  • Find UI is missing
    Description On a website with active directory membership and role provider active, the tab for Find is missing.  The Find tab relies on SearchAdmins group as well as WebEditors. Those groups cannot be created in Active directory and adding virtual roles for WebEditors and SearchAdmins does...

  • See all 28 articles
  • Content Authoring


  • Unrelated documents visible under asset pane "For this block"
    Description This article describes an issue when a new block is created there are unrelated documents that appear under the asset pane in the "For this block" section. A similar issue was found in an upgraded site from 7.1 to latest Episerver. Product Development investigated and f...

  • Database


  • Foreign Key Constraint Issue on Inserts
    Description When making updates to Episerver you get an error "The INSERT statement conflicted with the FOREIGN KEY constraint". Resolution This is generally caused by either multiple web sites or multiple web environments (development, staging, integration, production, ...

  • Legacy Subscription Job does not work correctly with UTC dates
    Description This article describes an issue with the SubscriptionJob not generating subscription emails after having applied the Episerver UTC update. Subscription is a legacy system in Episerver from version 4 (back in 2004). Subscription allows website visitors to subscribe by e-mail to w...

  • Database upgrade error Episerver CMS 9 to CMS 10
    Description Upgrade from CMS 9 to CMS 10 but you get an error upgrading the database: Update-EPiDatabase -Verbose:$trueC:\..\packages\EPiServer.Framework.10.10.4\tools\epideploy.exe -a sql -s C:\..\.. -p C:\..\packages\EPiServer.CMS.Core.10.10.4\tools\epiupdates\* -c EPiServerDBFound locati...

  • Episerver Content Import Fails In DXC With FOREIGN KEY Constraint Error
    Description This article describes an issue where importing content from one DXC environment to another you get the following type of errors below and the import fails. The following errors have occurred: [Importing content 21006_26699] Exception: The INSERT statement conflicted with the FO...

  • How to Determine your Episerver Database Version
    In certain circumstances, such as a deployment, you may want to verify that you have the correct Episerver database version for your CMS package. Here are the steps for that. Resolution 1) Run the following stored procedure. declare @ver intexec @ver=sp_DatabaseVersionprint @ver...

  • Empty Recycle Bin - Episerver 6
    If you run into an issue with the recycle bin not emptying in Episerver 6 this query may help. Resolution Please only run this if you have exhausted all other options Run the following query against the database -EXEC editDeleteChilds @PageID =2 @ForceDelete = 1) //where 2 is ...

  • See all 8 articles
  • Editor


  • Preview unavailable on copied page types
    DescriptionThe Copy Page Type function lets you add a new page type to the CMS. But, a preview is not available for new pages added this way.   CauseThe Copy Page Type function of the Admin interface is legacy functionality. It was originally designed when Episerver content items were mostly ha...

  • Observable store detected javascript warning in edit mode
    DescriptionWhen logged in and editing, the following message is displayed in the javascript consoleObservable store detected, but no sort order specified. You may experience quirks when adding/updating items.  These can be resolved by setting a sort order on the list or grid.  ResolutionThi...

  • External links are converted to permanent links
    DescriptionWhen adding an external link in edit mode, if the link exists in the system it will be converted to a permanent link.  ResolutionThis is intended functionality for the system. External links are mapped to permanent URLs if the host part can be mapped using the site settings. The reaso...

  • Expected Functionality of External Links
    There have been a few tickets recently where when adding a link in the edit interface to another item (entered as an external link), the link reverts when saved to an internal site link. Resolution Currently this is how the product is designed to work as the CMS finds the link a...

  • Error in Edit - Unable to connect to the web server. What would you like to do?
      When trying to edit in Episerver CMS some users get a dialog stating, "Unable to connect to the web server. What would you like to do?" There will also be errors in the browser console similar to what is seen below. 317 {message: "Unable to load /adminui/shell/Stores/conte...

  • Dot Notation Support Removed In Dojo JavaScript Loader In Episerver 10
    This article contains information on the breaking change with dot notation. In Episerver CMS 7, the code was using a version of Dojo that had its own synchronous loader which used dot notation. In Episerver CMS 7.1, changes with Dojo dependencies forced the use of slash notation. Up unt...

  • Installing and Upgrading


  • InvalidOperationException: Collection was modified
    Description This article describes an intermittent exception on startup caused by async registration of localization providers for modules because XForms translates text too early.  The error in stack trace is seen below. [InvalidOperationException: Collection was modified; enumeration oper...

  • Errors on migration page on upgrade (Migration failed)
    Description If you get the error message: 1. Migrates published Catalog Content has failed with exception 'System.Data.SqlClient.SqlException (0x80131904): Execution Timeout Expired. or 2. Failed to clean up meta keys: Execution Timeout Expired. The timeout period elapsed prior to completio...

  • WebSocket Protocol Issue When Upgrading
    When upgrading your Episerver CMS UI to the latest versions, you may run into a websocket protocol error. This article provides links on this change and how to resolve the issue.  can't establish a connection to the server at wss://yoursite.com/EPiServer/Shell/socket/endpoint/.socket = ...

  • Installing Commonly Used IIS Features Using Powershell
    This article provides a set of powershell commands which will install commonly used IIS features. Resolution Run powershell as an administrator and run the following commands to install a set of commonly used IIS features. Import-Module servermanager Install-WindowsFeature Web-A...

  • How to Setup an Older (Prior to Version 9) Episerver Site Without Deployment Center
    Description The Visual Studio extension makes it easy to create new Episerver solutions and projects from scratch. However, if you were to have the latest version of the extension, it would by default setup a version of Episerver that is more recent. For example, version 10.0.1.202 released o...

  • How To Find the Episerver CMS Version
    DescriptionThis article illustrates the different methods to locate Episerver CMS Platform version information. ResolutionThe image below shows the following options to find the version number.In Admin mode, click the Config tab > Plug-in Manager.View the title of the editor/admin mode b...

  • Personalization


  • NumberOfVisitsCriterion cookie never expires
    NumberOfVisitsCriterion cookie never expires and is set to a date like December 9999. Cause The date for when the NumberOfVisitsCriterion cookie should be expired is set in the Episerver assemblies. Resolution Some options around it: 1. Create a duplicate of the Number o...

  • Search


  • Using Wildcard and Synonym searching in Episerver
    Description Episerver has the ability to do Wildcard and Synonym searching and you would like to use them both at the same time, unfortunately Episerver does not currently support this configuration of combined searching. Resolution Due to how Wildcard and Synonym search currently...

  • How to Combine Standard Sort Orders with BoostMatching
    Description The article describes the issue when trying to add sorting of non-BoostMatching results with BoostMatching filtered results. The issue is that when adding sort to the results it will be ordered in that sort order only. The "score"-mechanism will be replaced, which make...

  • Find Index - Public and Private Urls
    Description What is the difference between the public and private find url's and when to use them.  Resolution The answer is the index permission. The Public URL enables Read permission only while the Private URL allows Read-Write. With Public Url the GET operation can be used to ...

  • Episerver Find - related queries on current site on a multi-site
    Description If you have a multisite installation and want to get related queries filtered on the current site. Resolution What you can do is to do something like this: var didyouMean = client.Statistics().GetDidYouMean(model.Query, x =>            {                x.Size = 10; ...

  • Removing page type from Episerver Search results
    Description To remove page types from episerver search(lucene) search results do the below.  Resolution Add the ISearchable interface to your class and add the following properties.  public bool AllowReIndexChildren { get { return true; } } public bool IsSearchable { get { return ...

  • Multi-words synonyms don't work if query contains WithAndAsDefaultOperator
    DescriptionMulti-words synonyms don't work if query contains WithAndAsDefaultOperator.  For example: if (!String.IsNullOrWhiteSpace(query.QueryString)) { search = search.For(query.QueryString) .InAllField() .WithAndAsDefaultOperator() .UsingSynonyms(); }CauseThe issue is with how the token...

  • See all 8 articles
  • Security


  • Magic Number And Signature Audit For File Upload Security
    DescriptionEpiserver has out-of-the-box field validation for file type, file size, and number of files uploaded but it does not have magic number/signature audit.  This article contains recommendations for additional magic number file upload security.ResolutionProcessing application requests in ...

  • How To Set EPiServerLogin Cookie Secure Flag
    DescriptionThis article describes the step needed to set the secure flag on the episerver login cookie.ResolutionSetting “requireSSL” on the EPiServer login form in the web.config resolves the issue. <forms name=".EPiServerLogin" loginUrl="Util/login.aspx" timeout="12...

  • Social


  • Connect For SharePoint: UpdateDocument and DeleteDocument Not Triggered By Sharepoint Update
    Description This article clarifies the additional steps needed for the UpdateDocument and DeleteDocument events to fire when implementing ISharePointProcessor to import documents from SharePoint Online to custom MediaData objects in Episerver. This article is an addendum to the information ...

  • MarketingAutomationIntegration.Eloqua Throws Cryptographic Error
    Description When setting up the Eloqua connector, an error may be displayed similar to:  Error occurred during a cryptographic operation. Description: An unhandled exception occurred during the execution of the current web request. Please review the stack trace for more information about th...

  • Troubleshooting


  • Remote Events High CPU/Network Utilization Bug Found in CMS 10
    DescriptionIf you are using remote events (this affects all event providers) and then upgraded to CMS 10, you may have noticed a major bug where if a page were moved to the trash bin, you would notice a spike of CPU resources and network utilization that will remain until an appPool or IIS reset...

  • EPiServer Debugging Tools
    Description This article discusses useful debugging tools when working with custom development within an Episerver site. Resolution Below are some URL commands that can be used and the steps to configure this debug. /<episerverUI>/Shell/Debug/InitializationModulesLists out a...

  • An item with the same key has already been added error in the log
    Description This article describes an issue where a production site displays the following errors in the log. It appears there is a linkitemcollection of the type relatedlinks on some page which throws this error. Why is this error thrown and how is it resolved? ERROR EPiServer.Global: 1.2....

  • Performance issue with Episerver Find on Azure
    Description This article describes an issue where there are a lot of requests to https://dl.episerver.net/version.json which take really long to response.  Resolution This following blog post should resolve the issue.  http://dmytroduk.com/techblog/customizing-how-statistics-track...

  • The provided content link does not have a value. - variant page
    Description Sometimes the website product / search pages throws the following error The provided content link does not have a value. Parameter name: contentLink After the website restart it begins to work properly. Resolution This was caused by a bug http://world.episerver.com/sup...

  • Could not load file or assembly 'xxx' or one of its dependencies error
    Description Customers may run into a very common error message during development as shown below: Resolution The system could not find the 'Episerver.Forms.Core' assembly file to load. There are some workarounds for this issue: The dll file may not be in /bin folder. Just copy t...

  • See all 17 articles
  • UX


  • ImageDescriptor blobs not clearing when replacement image is uploaded.
    Description When using ImageDescriptors blobs for Media, you may have an issue where only the default Thumbnail image is being regenerated when you upload a replacement image and not additional ImageDescriptors.  If you have others setup, they are not updated and instead you have to manuall...

  • Pages Search in CMS Edit UI does not return results.
    Description When you enter the CMS Edit page and pull down the tree menu, if you use the search functionality to find a page no results are returned even when they should be. Resolution This is a known bug in the CMS product, if your experiencing this issue please follow the below...

  • Visitor groups not collecting data
    Description When using Visitor Groups in Episerver, the Visitor Group Statistics widget doesn't appear to be collecting statistics for the Visitor Groups. Resolution The statistics are not updated immediately, but by default every 20 minutes. For testing you can decrease the valu...

  • Something Went Wrong: Failed loading content with url/url: epi.cms.contentdata:///
    Description This article describes an error message that can appear in the Episerver workspace and how to resolve it. The error message is: Something Went Wrong: Failed loading content with url/url: epi.cms.contentdata:/// This is because there is a site definition issue in the database. ...

  • How to change the scheduled publish job interval.
    Description This article describes how to change the scheduled publish job interval in the admin interface. Resolution In the admin ui, go into CMS -> Admin -> Publish Delayed Content Versions Set the job interval to your desired interval in minutes. Once saved, it should k...

  • Upload Media Error: Timed out, or max file size exceeded
    Description This article demonstrates the web.config changes needed to increase the default size and request options for media uploads.  In this example the settings will support up to 500 MB uploads and are stock Alloy starter site web.configs. Resolution Please compare the two c...

  • See all 9 articles