Add-ons


  • Site performance impacted by BVN-404 handler
    The BVN-404 Handler, a popular add-on gadget to Epi CMS, was indirectly impacting site performance. The BVN-404 Handler gadget logs 404 errors and manages redirects.  When a 404 occurs, the handler logs it into the BVN.NotFoundRequests table in the CMS database. The CMS admin, using a G...

  • SharePoint connector
    Resolution

  • Installing CMO on Episerver 9
    Instructions on how to install CMO on an existing  Episerver  8 or greater existing site (workaround). Cause Currently, the officially supported way of installing CMO requires one to install the add-on via Deployment Center to a CMS site running 7.5.394.2. However, with many clie...

  • If Episerver Languages add-on is installed, projects cannot be deleted
    The article contains the resolution to the issue where the Delete option is grayed out in the project gadget and project bar when the Episerver Languages add-on is installed on the system. Resolution This issue is resolved in EPiServer.Labs.LanguageManager 3.0.1 . For more infor...

  • API


  • Uncaught Reference Error: $ is not defined
    Description When not logged into EpiServer JavaScript does not seem to run and a "Uncaught Reference Error: $ is not defined" is found in the developer consul but the JavaScript runs fine when logged in. Resolution This is caused by jQuery not being loaded. When logged i...

  • How to add a media item via the API
    This sample illustrates how to add a media block type to the CMS. This assumes you have a Article page type but really you just need to pass in a ContentLink to the location you want to save the file to.  Resolution Below are some sample methods to add a new blob and insert data...

  • Find UnifiedSearch() Sample Template
    DescriptionThis is a sample template that uses Find and UnifiedSearch() to return the results.ResolutionCode Download To use, unzip into the site root and browse to the page.http://mysite.com/UnifiedSearchTest.aspx?query=alloy This was tested on Alloy 10.x.

  • How to get all languages tied to a fallback language
    This article contains the code segment that can retrieve all languages tied to a fallback language configured in the cms. Resolution ContentLanguageSettingsHandler.Instance.Get(ContentReference.StartPage).Where(s => s.LanguageBranchFallback.Contains("de", StringComp...

  • Authentication


  • 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...

  • Error When Clicking On Create User and Administrator Groups
    This error occurs when calling on the EditUser.aspx and AdminGroup.aspx repectively. [DirectoryServicesCOMException (0x80072030) There is no such object on the server] Resolution The error is associated with an incorrect reference to an LDAP path that is invalid. In order to res...

  • Active Directory Users and Groups Limit (1000)
    Active Directory LDAP queries are limited to returning 1000 objects (users and groups). Here are some suggestions to get around the query limit. Resolution It might be possible to change this server side, as suggested in this link: http://stackoverflow.com/questions/3488394/c-sh...

  • Commerce


  • Shell Initialization Errors in Commerce Manager When Updated to v10
    Here is the following exception you may encounter upon upgrade: Value cannot be null.Parameter name: virtualPath]in EPiServer.Shell.ShellInitialization.WaitForInitializeModules() Cause You may have the following dlls in the /bin folder: EPiServer.Cms.Shell.UI.dllEPiServer.UI.dllE...

  • Links to products in specific catalog(s) give 404 errors
    If a catalog name also exists as a CMS page name, links to the Commerce or CMS content may give a 404 error message. Resolution This is a known issue that can be avoided by upgrading to the latest Commerce version. In that version, a warning is given when attempting to name a Co...

  • Issue Adding Packages To Bundles in Catalog UI
    This article covers the issue that users are having with adding packages to bundles in the new Catalog UI. Resolution This feature was only available in the legacy Commerce Manager and not the newer Catalog UI until now. For more information please look at the following Episerve...

  • EventsPublishedContent Event Does Not Fire When Service API Adds Product To System
    This article contains information on why the EventsPublishedContent event does not fire when using a service to add the product. Resolution The content published events are not fired because the service API uses the low level API to update catalog content. It is on the backlog t...

  • Creating the Sample eCommerce site, QuickSilver
    Description If you are developing using Episerver Commerce, you can use the QuickSilver site for code examples and for testing the Commerce API. Here's how to set one up. Resolution Prerequisites:  An instance of SQL, either on the server or another box. An AD user with dbcreator on ...

  • Commerce v10 Upgrade Error: "Switching AllowNulls to false is only supported for catalog meta classes"
    Commerce R&D made changes in the latest 10.1.1 package to make cross-reference of metafields (for example, using a meta field in both catalog and order contexts) an exception/error, hence why the error upon upgrade. Technically speaking, there's nothing inherent in Commerce that wo...

  • Configuration


  • Page loads slower after updating to .NET 4.7
    Description The following issue occurred in Microsoft's 4.7 .NET framework update.  "The internal implementation of System.Web.Caching.Cache uses Coordinated Universal Time (UTC) time-stamp for absolute expiration. But this particular Cache.Insert (string, object, CacheDependecy, DateT...

  • The link you specified does not work. This may either be the result of temporary maintenance or an incorrect link
    Description After deploying to an Azure environment the following error message is thrown when attempting to access or log into the site. Page could not be loaded The link you specified does not work. This may either be the result of temporary maintenance or an incorrect link. Resolut...

  • Cloud Flare not caching images when cache-control is public
    Description When images have a there Cache-Control header set to "PUBLIC" CloudFlare's CF-Cache-Status header is set to "MISS" causing images not to be served from the CDN cache even when the web.config file is properly configured to allow caching of images. Resolu...

  • Uploading Blobs to Azure Storage with PowerShell
    This article describes the PowerShell command to upload local Blob storage to Azure Blobs  Resolution When uploading media in Episerver, the binary data are stored in a system called blob providers. By default, media are stored on disk in a folder located at <path_to-site>...

  • Set <staticFile> Configuration in web.config to Ensure Latest Media Files Retrieved Client Side
    Media asset caching is controlled by configuration. The associated class that handles this is EPiServer.Web.StaticFileHandler. This class inherits from MediaHandlerBase which is in the same namespace as StaticFileHandler. Within MediaHandlerBase there is a method called SetCachePolicy w...

  • Reusing the same License.config file across multiple Episerver sites in your local environment
    If you have a local environment where you have added multiple episerver sites in IIS, it can save you time to use the same License.config file across all sites. For example, let us say you went to license.episerver.com. You created and downloaded a partner developer license that was bou...

  • See all 10 articles

    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, ...

  • 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 ...

  • Determining largest tables within a database
    DescriptionAt times Support may ask for verification on the largest tables in a database either when investigating a performance issue or when investigating various functionalities of a site. The below steps detail how to verify what tables are taking up the most amount of space wihtin a databas...

  • A network-related or instance-specific error occurred while establishing a connection to SQL Server on EPIServer installation
    When installing an installation of EPIServer on a local machine the following error message is thrown by the site on compilation. A network-related or instance-specific error occurred while establishing a connection to SQL Server. The server was not found or was not accessible. Verify t...

  • 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/cont...

  • 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


  • 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


  • 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...

  • How to Get Find Autocomplete Results Only For the Current Language Branch
    Episerver Find has a nifty autocomplete feature which allows users to get suggestions as they are typing their search query. If you have a multi-language site, autocomplete by default will return suggestions from all languages. If you want to return autocomplete suggestions only from th...

  • Find Index Timeout with OnPublish Event
    The error you might see in your log is this: EPiServer.Logging.Compatibility.LogManager+CompatibilityWrapper.Error - An exception occurred while indexing (IContent). The operation has timed out. EPiServer.Find.ServiceException: The operation has timed out ---> System.Net.WebException...

  • 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


  • 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


  • Static Files Return 302 Outside Edit Mode
    DescriptionYou may run into issues upon deployment of an Episerver site where static files (.js, .css, etc.) aren’t loading in View mode, but will render when you are logged into Edit mode. Since static files will load within Edit mode context, then the logical assumption is that anonymous users...

  • Sorting Limitation in the Admin/Config/Edit Categories
    DescriptionThere is a sorting limitation in the Admin/Config/Edit Categories.  This article will provide sample workaround code to sort these categories.ResolutionEPiServer categories seems to have no built-in sorting when retrieving them as a list when using CategoryList. Each one of the specif...

  • Scheduled Jobs and Time Changes
    DescriptionThere is no cause for concern since this is considered by design by the CMS developers.ResolutionScheduled jobs run on UTC time internally so no daylight saving time or shift to standard time is taken into account. What you see in the UI is converted to local time so it may look stran...

  • 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...

  • MS Office Add-on Support for Latest Versions
    DescriptionDue to the removal of ContentChannel and related classes starting with CMS 9 (as part of a breaking change), Episerver Publish from Office add-on is not supported in CMS 9 or later.ResolutionAs of writing, there are no plans to release a new version of the add-on. If there are plans t...

  • Legacy Episerver FAQ's
    DescriptionPlease reference the link below for troubleshooting older versions of Episerver (v4 and v5)Resolution/hc/en-us/articles/115004126446-legacy-episerver-faq-s

  • See all 11 articles

    UX


  • 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...

  • Multi-step forms not working properly
    DescriptionWhen setting up a multi-step form, the form fields all render at the same time and thus the steps are broken.  ResolutionIn order to render multi-step forms correctly, the injectFormOwnStylesheet must be set to true if a cusom stylesheet isn't declared. By setting this value to t...

  • Missing Text message in UX
    DescriptionWhen viewing UX, you may run into a message for missing text for a particular language similar to: [Missing text '/dope/gotomydashboard' for 'Chinese'][Missing text '/dope/gotoeditview' for 'Chinese'] ResolutionIt could be that your FileXmlLocalizationProvider is broken  Make sure you...

  • Missing block and media folders in assets pane
    DescriptionThe block and media folder trees don't show up in the assets pane.Resolution Go to admin view -> Config tab -> Manage Websites -> Websites tab. Click the affected site. Uncheck the Use site-specific assets box and click Save. Go back to edit view. Make sure you can see the bl...