Analytics


  • Analytics Report Error: An internal error occured.
    Description After you set up Google Analytics using the OMAP 2.0 method, the following error occurs in the analytics reports: An internal error occurred. Resolution Check your app pool identity: Open IIS Manager. Select application pools. Select the site's corresponding app pool. Sel...

  • Business Analytics EventReporter.GetList() ignores filter by taxonomy
    DescriptionThe EventReporter.GetList() API is not filtering by taxonomy.  This will affect the Most Popular Widget and the AnalyticList control functions for filtering by Taxonomy.ResolutionThe issue was reported in issue #70375.  Updating to 8.61 with the latest Cumulative Update or higher vers...

  • Configuring tracking code for Google Analytics
    DescriptionAfter configuring Google Analytics on a site, reports show no information when browsing the site.CauseTracking code has not been inserted into the templates to allow Google to track the information for the site. ResolutionThe recommended method is to leverage the Google tracking ...

  • Configuring your Ektron Site for Google Analytics
    DescriptionHere are the steps necessary to configure your Ektron site with Google Analytics. ResolutionCreate a Google Analytics User AccountCreate a Gmail account (http://mail.google.com).Sign up for Google Web Analytics (www.google.com/analytics/).Open a browser and navigate to https:/...

  • Error in Google analytics report: Input string was not in a correct format
    DescriptionIf your analytic report shows the error Input string was not in a correct format , it indicates an issue with the Web provider's section in web.config or an issue with the allowed providers in your Google Analytics settings. ResolutionGet the steps at Setting Up Google Analy...

  • Error: The remote server returned (403) Forbidden
    DescriptionError:  The remote server returned an error: (403) Forbidden. ResolutionLogin into the Google Developers console and turn on Analytics API.

  • See all 13 articles
  • API


  • .Net error when using getList methods
    DescriptionWhen using a getList method in Ektron 9.10, you may get an error:  The parameter data type of UInt32 is invalid.  This error occurs by passing a long value directly to a criteria object. For example: criteria.AddFilter(TaxonomyProperty.Id, CriteriaFilterOperator.EqualTo, 2147484121); ...

  • Add a collapse option for the Ektron Toolbar
    DescriptionWith the current Ektron Toolbar, when editing a page builder page, there is no way to collapse/hide the toolbar from view. This can be problematic if you have a content item that needs to be edited that abuts the top of the page. The code sample below shows how to add an option to all...

  • Add Language to Metadata Definition using MetadataTypeManager
    DescriptionThis article provides a sample that will take an existing metadata definition and add it into the CMS with a new language. ResolutionCode Download* Note - This sample uses the MessageUtilities. Please refer to this KB for more information. Code files included.

  • Add New Language For Existing Content With ContentManager
    Description This article shows a sample and describes the steps to leverage the ContentManager to programmatically add new language versions of content for existing content items in the CMS retaining the same ID. Resolution 1. Call the ContentManager.GetItem to pull the existing c...

  • Adding a user data object with required and custom properties to the CMS
    DescriptionIt is a simple task to add users to Ektron via the Ektron Framework API.When entering any user data object into Ektron, you need to complete two types of properties. Below is an example of a user data object for a membership user that has the required properties and customer propertie...

  • Basic Captcha Example using the Ektron Server Controls
    DescriptionEktron has built in captcha support right out of the box. Here is an example of how you could implement it on a template. Resolution<%@ Page Language="C#" %><%@ Register Assembly="Ektron.Cms.Framework.UI.Controls" Namespace="Ektron.Cms.Framework....

  • See all 62 articles
  • Authentication


  • 401 error using Windows Authentication and SSL when accessing form reports in the workarea
    You're suddenly seeing a 401 error while trying to access the form reports functionality in the workarea when using Windows Authentication and SSL.  Error transforming XML with XSLT. Error Message: An error occurred while loading document 'https://www.mydomain.com:443/WorkArea/...

  • Adding Active Directory Users to SQL Role Groups
    Description When trying to add an Active Directory User to a SQL Role Group the groups from SQL do not show in the list. Resolution Ektron does not support mixing SQL roles and Active Directory Users or vice-versa. When using Active Directory for your user management you will also...

  • Application Pool Recycling Causes Session Loss
    Description This article describes the steps needed to help prevent sessions loss due to application pool recycles. Resolution Ektron supports sticky sessions as seen in the min site web.config. <!--  SESSION STATE SETTINGS          By default ASP.NET uses cookies to identify w...

  • Configuring Single Sign On (SSO) with Active Directory - Documentation Supplement
    DescriptionThis article supplements the product documentation to provide better understanding of the settings in configuring SSO with Active Directory.ResolutionTo better understand what Ektron is requesting for settings, it is important to understand the ASP.NET Architecture of how client reque...

  • Connectivity issue with search, notification service or DXH?
    DescriptionAre you running into a connectivity issue with search, notification service or DXH? Do you receive a 403 forbidden error?If so, this is likely as a result of securing the Ektron WebServices without deliberate and specific measures taken to expose them based on IP.ResolutionPlease foll...

  • Enabling NTLM Authentication (Automatic logon)
    DescriptionNTLM (NT Lan Manager) is a Microsoft authentication protocol that enables a user on a Windows domain to authenticate with a website through the browser. NTLM passes the credentials of the user currently logged-in on the machine, on the Windows domain, to the browser to authenticate wi...

  • See all 13 articles
  • Browser


  • Browsers supported based on Ektron version
    Inconsistent behavior occurs with some browsers, but not others. Often, incorrect behavior is noticed with earlier versions of Ektron being used with the latest browsers. Cause Ektron browser support is based on the time period when the browsers were released. Later versio...

  • Calendar not working properly in IE10
    When using IE10 and a calendar control, the "forward" and "back" buttons on the control do not work properly. When the arrows are clicked, a screen with a loading, spinning, icon will appear and will not resolve unless the screen is refreshed.  Also, if debugging too...

  • Chrome Crashes When Editor Closes
    We have discovered that spyware or adware can cause ActiveX controls, such as the editor, to no longer function properly. In particular, we have seen pop up blockers and the Alexa toolbar crash the editor. Resolution It is recommended that you scan your system for spyware...

  • DMS Drag-Drop Hangs with Firefox 17 and higher
      Changes to Firefox versions 17 and higher. As a note the drag and drop functionality was removed in version 8.6 of the Ektron product line, so these steps would be relevant only for versions 8.5 sp3  Resolution Follow these steps to upgrade to the latest version (3.2.4) of Ektron...

  • Ektron Browser Support
      What browsers are currently supported in the CMS in the most recent version? Resolution For browser support, we have a documented page that lists out supported browsers in each major version. Please refer to this link for updates to the browsers that are supported. http://world.e...

  • Firefox 39.0 not allowing individual words in table cells to be selected when using Aloha
    When upgrading to Firefox 39, you are no longer able to select individual words in a table cell when using the Aloha Editor. Cause Firefox update version 39.0 Resolution Currently there is no workaround for this issue other than staying on version 38 or lower. The ...

  • See all 16 articles
  • Commerce


  • Duplicate Product Entries IDs in Workarea
    DescriptionIn some cases sync collisions can occur causing duplicate product entries to show in the workarea. See the following example: Resolution To prevent the issue from occuring you will need to start by resolving sync collisions for price entries. Go into the workarea > settings > sy...

  • eCommerce Content not checking in using the workarea
    There are rare occasions when eCommerce catalog content cannot be checked using the workarea. For example, one user who is not available may have left content checked out but another user cannot check it back in. Resolution When a content item cannot be checked back in us...

  • Ecommerce Workflow Image Not Showing
    DescriptionThis article describes steps to take when previewing the Available Workflows under Settings > Commerce > Fulfillment >Order Workflow and no image is present.CauseThere are two primary causes for the workflow image to not appear in the workarea. 1. The MSDTC is not configured ...

  • Example on how to create a custom order process workflow for eCommerce site
    DescriptionDevelopers have the option to use Ektron's standard functionality and out-of-the-box server controls to create an eCommerce website. See eCommerce Server Controls for more information.Ektron also provides the ability to customize an eCommerce web site by creating a process workflow ta...

  • Issue with eCommerce transactions remaining in inProcess
    DescriptionTypically with eCommerce transactions, unless specified, when an order is placed it needs to go through a workflow process before the transaction is complete. In the Workarea, there will be an indication that the order was completed successfully as the status will be marked Completed ...

  • Modify Commerce Screens
    In the event that you need to change or modify your commerce screens for shipping providers, addresses etc, there are a few different options you have.  Resolution   Modify the code itself    Install the Ektron SDK : C:\Program Files (x86)\Ektron\CMS400v86\Utilities\CMS...

  • See all 12 articles
  • Configuration


  • Adaptive Imaging Issue: Cannot Add Breakpoints in Settings
    In 9.10, the button to add adaptive image breakpoint sets does not function. Use the workaround in the solution until a fix is released.  Resolution Enter http://<yourHostName>/workarea/mobilesettings/addeditbreakpoint.aspx in your browser. Add breakpoints and clic...

  • Add acceptable XSLT files to the system
    For security reasons, external XSLT files with customized XSLT might not work with the Content Block server control's DisplayXSLT. This document describes how to add your acceptable XSLT to Ektron. Resolution To add acceptable xslt files to the whitelist for Ektron to pro...

  • Adding Templates to the CMS
    DescriptionThis article covers how to add a new template to the CMSResolution Open the workarea folder. Navigate to settings > configuration > template configuration Click add new template to system Specify the template location or click the elipsis to browse the site root to find it. Fill...

  • Application Pool Crash With Device Detection Turned On
    Description In rare instances there has been an issue on 9.0 - 9.1 sites with device detection set to true where CPU usage quickly escalates to near 100%. Due to the high consumption of resources a thread abort error is given and the application pool may crash.  To identify if this is your ...

  • Can not add conditions in Targeted Content Widget.
    Description When you click on the "+ or" button to add a new condition for use in the Targeted Content Widget nothing happens. Resolution There is a known bug in the Ektron Targeted Content Widget that, under certain conditions, will prevent users from being able to add ...

  • Canonical URLs and Ektron
    Canonical URLs are a method for improving the SEO of pages that contain multiple URLs pointing to the same pice of content. Cause The Ektron product line does not currently have an out of the box method for setting Canonical URLs for content items with multiple URLS pointing to t...

  • See all 43 articles
  • Content Authoring


  • Content not automatically publishing/archiving at start/end dates
    Description In 9.2 and 9.2SP1, the Ektron Windows Service will not execute publish and archive actions at the scheduled times. Resolution This can be resolved by updating to 9.2 SP1 Service CU 1 or higher. EKTR-168 Downloads

  • Adaptive Images not Updating when Original Image is Modified
    If the original uploaded image is modified in a system set up for adaptive imaging, the associated adaptive images are not updated to reflect that update. Resolution Upgrade to 9.1SP1 or remove the ancillary images created for the original uploaded image. The latter wi...

  • Adding Library File Type Throws Error
    When adding a library type in the cms, you are presented with an error message if the type is not whitelisted in the web.config. Resolution You edit the library file types and are presented with an error. Not having the file extension whitelisted in the web.config. Open t...

  • Alias Already Exists Error
    DescriptionWhile creating content and attempting to add a manual alias, the error message below appears. The error prevents you from saving or publishing the content.  CauseThe manual alias already exists in the CMS. ResolutionUpdate the existing content and change its manual alias. Or...

  • Aliases for Archived Content Not Removed
    What happens to url aliases associated with a content item when it is archived? Resolution When archiving a content item, aliases are retained. This is by design as archiving a content item keeps the content item in the system. If the content item is deleted the aliases will be ...

  • Best Practice: approval process
    DescriptionWhat are approval process best practices?Why can't I see all checked in/out and submitted content in my reports or on my Workarea Smart Desktop?  ResolutionEditors submit content to the Level 1 Approvers.Level 1 Approvers submit content to Level 2 ApproversLevel 2 Approvers submi...

  • See all 60 articles
  • Database


  • Automatic Aliases For Certain Content Not Present in CMS
    Description This article describes an issue with Ektron Automatic aliases that are not present in the CMS. In the database for these aliases there will be negative mapping IDs. An example is seen below. Resolution To resolve the issue please follow one of these directions: If th...

  • Change content status via database
    DescriptionWhen you need to change the content status via the database, you need to change more then just the content_status column in the content table. This process may need to be run in cases where a content item is displaying an error in the workarea, or the status is not in a recognized sta...

  • Clarification on encrypting an Ektron database
    Description What methods of encrypting the Ektron database have been tested and are supported? Resolution Encrypting the Ektron databases further has not been tested within the Ektron CMS. Many forms of encryption are likely to cause issues within the CMS, but is is suspected that...

  • Clearing Your AssetServerTable
    DescriptionOccasionally when troubleshooting issues, such as eSync and Go-Live functionality, the support tech may ask you to clear out your "AssetServerTable" and stop and start the Ektron Windows Service.  ResolutionWhen requested to clear the "AssetServerTable", pleas...

  • Clearing Your perform_action table
    DescriptionWhen troubleshooting Go-Live or archive issues, a support tech may ask you to clear your perform_action table.The perform_action table acts as a "bucket," where current actions in the CMS are temporarily stored. For example, if you publish content, the content temporarily re...

  • ContentManager.GetList returns incorrect results when run recursively.
    DescriptionIncorrect results may return when using the API below with the recursive property set.  In this case, results from other folders may appear in the results. ContentManager cm = new ContentManager(Ektron.Cms.Framework.ApiAccessMode.Admin); ContentCriteria criteria = new ContentCri...

  • See all 26 articles
  • DxH


  • Cannot log in when CMS and SharePoint are on Different Domains
    DescriptionSharepoint Connector: Cannot log in when CMS and SharePoint are on Different Domains ResolutionLog in to Ektron at least once using the browser that accesses SharePoint. This action starts the session and sets the login cookie.

  • DXH ContextBus Service Is Not Running On the Server
    DescriptionThis article covers the issue when the DXH ContextBus service will not launch on the server. A small note in the documentation indicates that TCP Port Sharing and HTTP Activation need to be enabled for proper service functioning. This is often missed and addressed here.ResolutionIf th...

  • DXH Form Mapping Submission Issue
    DescriptionDXH isn't submitting data into external system when form is properly mapped. This may occur on upgrades and not standalone installations.Resolution  Data not making it to DxH database Data not making it to target source   This can happen for one of 2 possible reasons   The form mappi...

  • DXH SharePoint Item Selection
    DescriptionThis article describes a known issue with selecting SharePoint items in release 8.6 SP1, and provides a workaround solution. The problem only occurs when you are importing SharePoint content using the item selection method, and you select more than onelist or library from which to sel...

  • DXH Version History
    DescriptionThere are multiple versions of the Digital Experience Hub (DXH). This article covers DXH version-related information.ResolutionFind upgrade and installation information for each version in the documentation . Here are the DXH versions that match up with Ektron CMS versions. Ektron...

  • DXH: Inbound Connection disappearing intermittently in multisite environment
    DescriptionWhen experiencing an issue maintaining connection to a DXH inbound connector on a multisite environment, it may be due to adding the connection in the DXHConnectionSettings of one of the sub sites.  ResolutionThis issue can be worked around by maintaining the connections via the root ...

  • See all 17 articles
  • Editor


  • 9.10 editor options are limited when editing a content block
    DescriptionThe 9.10 editor showed fewer Content Block options when you edited a content block in context. The following images show a comparison of 9.00 SP2 and 9.10 SP1. CauseIn version 9.10, was added to web.config , which limited editor menu functionality. ResolutionEdit sit...

  • Adding Custom Styles in 9.10 SP1
    DescriptionCustom styles added to the StyleConfig.js file are not showing up in the editor when you use the Inspector. CauseA few lines of code are commented out in the  Workarea\FrameworkUI\js\Ektron\Controls\EktronUI\Editor\Aloha\plugins\ektron\advancedinspector\lib\advancedinspector-pl...

  • Aloha edit in context menu is not closing after you click on the content block.
    DescriptionWhen using Aloha, the edit in context menu is not closing after you click on the content block.  CauseYou might notice this issue if you upgraded from an earlier version of the Ektron CMS and were utilizing eWebEdit400/Content Designer for your editor but are now using Aloha.If y...

  • Aloha jQuery Code Overrides other jQuery Versions
    DescriptionIf the wrong version of jQuery seems to be loading on your site or you are seeing numerous JS errors or warnings that do not apply to your version, the Aloha jQuery may be taking precedence over your jQuery. CauseThe order of loading the JavaScript library had Aloha.jQuery take c...

  • Applying Styles to Image Tags with the Inspector in Aloha
    DescriptionIf you are using the Aloha editor with Internet Explorer 10 and insert an image then open the Inspector, it shows responsive imaging options but does not display the tag in the top right. In some circumstances, you may want to apply styles to the image tag. This article explains how ...

  • Are your CSS Styles not showing up in the drop down?
    DescriptionAfter you have applied your custom CSS to an Ektron CMS folder you may notice that your styles are not appearing in the drop down menu.  ResolutionIt is possible the default CSS has been cached. To resolve this, please clear cache across all browsers. Firefox: https://su...

  • See all 50 articles
  • Esync


  • 'Caller was not authenticated by service' error during sync after disabling TLS 1.0
    Description If you are receiving the below error during eSync check to see if TLS 1.0 is disabled on the server. The caller was not authenticated by the service. Error executing strategy 'OnAfterESyncRunErrorFromPeer' remotely. Type 'System.ServiceModel.Channels.ReceivedFault' in Assembl...

  • .1 Duplicate File Issue
    Description.1 duplicate files in either assets, private asset, uploaded images, uploaded files, or templates caused by esync. ResolutionThe short term fix to correcting the .1 duplicate file issue is to delete the .1 and delete the respective knowledge files.If you do not know how to find o...

  • Aliases and eSync
    DescriptionWhat alias information moves over during a sync with the 9.X branch of the product?ResolutionAuto Aliases With the 9.X branch of the Ektron product, auto-aliases are regenerated during the sync process. This may cause temporary 404 responses on web pages. As such, it's recommended to ...

  • Assets not syncing over, eSync knowledge files, WSRM: Identifier error
    Description Assets, private assets, uploaded files, uploaded images, or templates are out of sync, not syncing to/from servers, or load balancing correctly. Resolution If assets, private assets, uploaded files, uploaded images, or templates are not syncing properly, have .1 duplicat...

  • Auto Aliases not Working after Syncing
    DescriptionWhen a database sync is performed, an alias regeneration process is initiated on the receiving server. If the aliases are not regenerating, an update may fix your issue. ResolutionThe below issues are documented for 9.1SP2 and previous versions in the version 9 branch. To address thes...

  • Batch Write Failure Error: Replica with the specified key was not found
    DescriptionEsync may experience batch write failures when syncing databases. If that occurs you will see an error similar to the following.Sync (Regular Profile) Errored Out, Error: Ektron.DbSync.Core.RemoteDatabaseSyncException: Database Sync has failed on the remote EWS due to error 'Microsoft...

  • See all 92 articles
  • Globalization


  • Content Submitters in Approval Chain Able to Publish In Unexpected Languages
    DescriptionContent submitters in an approval chain may be able to submit content in languages other than the language used for the folder's first approval chain.CauseApproval chains are only setup for one language at a time, so if it's missing for a language, content submitters will be able to p...

  • Could not find part of path error on importing translated content
    DescriptionWhen attempting to import a translated XLIFF file the following could not find part of path error is thrown in the history for imported content, and the translated content is not imported.   CauseThis error message can be caused when the content that was exported for translation is ex...

  • Error: Culture is not supported
    DescriptionWhen you try to edit content in another language, the content does not open and the following error occurs: Culture is not supported . Y ou may also get an error in Windows Event Viewer similar to: error: culture is not supported. Parameter name: culture XXXXXXX (0x100002) is an inv...

  • How to disable languages that were created accidentally or are not needed
    DescriptionIMPORTANT : This procedure works on languages that are not already associated with content.Creating languages that are duplicates of pre-existing languages can cause a variety of issues within the Workarea and can confuse users.  CauseAdding languages lets you create related dial...

  • Machine Language Translation
    DescriptionThe old machine translation utility has been deprecated. This article will go over converting the machine language translation provider to Microsoft Translate. It is a fairly painless process, but does require some workarea modifications.An alternative approach is presented in another...

  • Not all metadata is exported for translation
    DescriptionWhen importing translated content some of the metadata definitions are not imported into the content, but some are. ResolutionThe CMS only exports metadata that is of the type text for translation. Other types of metadata such as yes/no and long will not be included in the export...

  • See all 9 articles
  • Licensing


  • A License Violation Has Occured Error and Potential Fixes
    DescriptionAfter entering our recently issued license keys we are receiving a license violation error."A license violation has occurred" ResolutionTypically, log in errors like this can be related to the license cache not updating as it should.Before running through the steps, ple...

  • Accessing Ektron License Keys
    Description This article contains information on how to retrieve Ektron License Keys Resolution We have changed the delivery process for licenses and will be moving away from the Ektron Customer Portal. Below are instructions on how customers can access their license keys. When vi...

  • How to Generate License Keys
    Description How to generate your Ektron license keys Resolution Go to and log in to the help center using your username and password. If you do not already have an account with world.episerver.com create one. Your registration request will be processed and an email notification sh...

  • How to Install License Keys
    Description You received new license keys from Ektron Licensing or Ektron Support. This article explains how to enter them into your workarea to allow you to continue using the CMS. Resolution Here's the procedure for adding license keys to your Workarea. From the Workarea, navigat...

  • License key has been modified error
    DescriptionWhen you update a license key, the following error occurs:  Your license key has been modified in a manner\nthat will prevent the editor from functioning.\nYour setup will not be updated. ResolutionThis error can occur when an invalid license key is entered, or there is a formatt...

  • License Key Module and Version Descriptions
    DescriptionBelow is a description of the various modules and versions one may find in Ektron license keys. ResolutionVersions and Modules eWebEditPro Keys   How to identify keys: No "(cms xy )" in key like in CMS keys.Possible key endings: -18, -2, -3, -4, -5          ...

  • See all 8 articles
  • Installing and Upgrading


  • UTC Converter Issues
    Description There are two major issues with the UTC converter. In older versions of 9.2 the UTC Converter will timeout and it gives the error "UTC Conversion Failed."  In all 9.2 versions the UTC Converter will incorrectly update the web calendar event table. This table did not r...

  • 0x80040707 Description:DLL function call crashed:ISRT._RegQueryKeyValue
    DescriptionWhen trying to run the Ektron Setup Installer some users report getting the following error: 0x80040707 Description:DLL function call crashed:ISRT._RegQueryKeyValue The setup then terminates. CauseTypically, the problem is caused by a missing or invalid path in the Windows ...

  • 9.10 Site Installer Issue; Database Install Options Presented in Site Upgrade
    DescriptionIf you back out of a database upgrade, then choose site upgrade, the following error occurs:WARNING! If you have not upgraded your site files, please run the CMS400 Upgrade before running the Database Upgrade.The installer then provides database installation options that you do not wa...

  • Accessing Ektron Product Downloads
    Description This article contains information on how to retrieve Ektron Product Downloads Resolution We have changed the delivery process for Ektron product downloads and will be moving away from the Ektron Customer Portal. Below are instructions on how customers can access the do...

  • Cloud Deployment Compilation Errors
    DescriptionIf you compile a min site in VS, compilation errors may appear from the cloud deployment files, CloudDeploymentWizard.aspx.cs and AmazonDeploymentWizard.ascx.cs . ResolutionIf you are not using the cloud deployment files, you can delete them without consequence.You also can e...

  • Could not load file or assembly 'Ektron.Cms.Framework.UI.Views'
    DescriptionYou received the error "Could not load file or assembly 'Ektron.Cms.Framework.UI.Views' or one of its dependencies." upon upgrading. ResolutionUpon upgrading from Release 8.5 RC 1 or RC 2 to 8.5. you see the following error: Could not load file or assembly 'Ektron.Cms.F...

  • See all 26 articles
  • Notifications


  • Clicking a community user or group displays 'Resource not found'
    DescriptionCommunity search results (and other server controls, such as CommunityGroupBrowser) use the TemplateGroupProfile and TemplateUserProfile properties to form quicklinks. In Release 7.6.6, these properties expected the templates to be relative to the currentfolder. But, in later versions...

  • Finding the Message Queue on your Server for Web Alerts
    DescriptionIn configuring web alerts users are asked to make sure that the message queue is installed and running as a component.  The information from our Product Documentation and MSDN has been compiled here to help point you in the right direction. ResolutionIn the Product Documentation ...

  • How to troubleshoot the Ektron Notification Service
    DescriptionThis KB article shows how to troubleshoot issues with the notification services, and emails not being sent out.While this post is designed to cover aspects of the Notification Service, if you are looking to go over notification emails, see Troubleshooting System Notification Emails ...

  • HTML form emails being sent with no values from the form
    DescriptionWhen a visitor submits an HTML form, an email is sent to the desired users. But the email contains little or no information from the submitted HTML form. CauseIn some later versions of Ektron, if there is a preamble field in the form's mail properties that retrieves information f...

  • Invalid Object name: ActivityPublishTargetQueue Error During Upgrade
    DescriptionThis error message appears during the database upgrade process:                                                         While one may be able to bypass the error by pressing "Ok", after the upgrade finishes, there may be certain odd behaviors like the images inside of the Up...

  • Troubleshooting System Notification Emails
    DescriptionThis article goes over some common troubleshooting steps to make sure system emails are working successfully.Note: This is used for the System Notification functionality NOT the Notification Service ResolutionVerify Settings in the web.config file  Open the web.config file in you...

  • Pagebuilder


  • Add a widget for selection on templates
    DescriptionThis article covers how to add widgets within the workarea to allow them to be selected on the front end of the website. ResolutionOnce your widget code has been deployed to the widgets folder in the site root of the website, complete the steps below in order to use it.Open the w...

  • Additional insight into the Targeted Content Widget:
    DescriptionQuestion: How does a targeted content widget that is dropped on a page builder page realize what targeted content widget found in the work area is associated with which segment for that dropzone.  ResolutionAnswer: The page builder targeted content widget has hidden columns and a...

  • Bootstrap 3 with PageBuilder modal window issue
    DescriptionUsing Bootstrap 3 on a PageBuilder page, if you add an Ektron control to the template and try to reference a modal window, the modal does not work. ResolutionThis is caused by an execution order issue.When you register Bootstrap 3 js, you should load it on page load instead of in...

  • Can You Disable or Hide the Ektron Toolbar in Version 9?
    DescriptionWe have upgraded our Ektron version to 9.0 and there's a new Ektron toolbar at the top while viewing the website while logged-in. Is there a way to hide this toolbar for a specific user group or just hide it for everyone in general? ResolutionThe Ektron site toolbar is actually c...

  • ContentBlock widget pagination is not displaying results
    DescriptionWhen you edit a ContentBlock widget that you expect pages of results for but they do not appear, a change to CSS in Ektron 9.10 may be causing the issue. Resolution1. Open the site root folder in file explorer. 2. Edit /widgets/ContentBlock.ascx . 3. Find the following line in ...

  • Device Configuration only allows 3 digits
    DescriptionCan’t enter more than 3 characters in the width and height text boxes under Settings>Configuration>Device Configuration. ResolutionIn a Windows Explorer folder go to C:\inetpub\wwwroot\CMS4008.X\Workarea\controls\DeviceConfiguration and edit the file named AddEditDeviceConf...

  • See all 31 articles
  • Performance


  • ContentManager.GetList with Fallback Language Performance Issue
    DescriptionA noticeable performance issue was observed when working with the ContentManager.GetList framework API.  The API would look similar to the example here.  int folderid = 0; Ektron.Cms.Framework.Content.ContentManager cMan = new Ektron.Cms.Framework.Content.ContentManager(); Ektron.Cms....

  • Error 4005 Forms Authentication Failed - Ticket Supplied Has Expired
    DescriptionIn your Event Viewer, you've begun to see a number of errors with the message "Forms authentication failed - Ticket supplied has expired" appear. Side effects may also include: 1. Slower site performance.2. Issues with Login function and retrieving user information for that ...

  • How to use Red Gate's ANTs profiler to troubleshoot performance issues
    DescriptionThis article provides a better understanding of how to use Red Gate's ANTs Performance Profiler to troubleshoot performance issues.ResolutionFor demonstration purposes, an Ektron OnTrek site is profiled in the Visual Studio Web Development Server. To set up ANTS Performance Profiler: ...

  • Performance - Worker Process Current Requests
    DescriptionWhen website performance suddenly becomes worse, there may be many potential causes (see Troubleshooting Performance Issues ). Gathering information about the current requests being handled by the worker process can help to identify issues impacting performance. The Internet Inform...

  • Performance Impact of Recursive Properties
    DescriptionThis article describes the performance impact on APIs when returning recursive properties such as content from child Folders and Taxonomy sub nodes.ResolutionSome Ektron APIs such as Content Manager and Taxonomy Manager offer recursive properties in order return data in child items su...

  • TaxonomyManager and ContentManager Related API and Database Performance Tips
    DescriptionThis article describes steps needed to optimize site performance around the heavy use of taxonomy and content list retrieval. ResolutionThis article explains the issues and provides steps for resolving them. 1. Updating Ektron version. 2. Refactoring template code. 3. Tuning the ...

  • See all 10 articles
  • Sample Code


  • Auto Complete Sample
    DescriptionThis autocomplete sample supports multiple words and multiple provider types (Solr, Search Server, Google, Bing). Settings can be modified in the autocomplete.js file.Also note that the autocomplete for Solr and Search Server works by splitting keywords on singular terms and concatena...

  • Basket Manager Framework API code sample
    DescriptionWith the roll out of the e-commerce Framework API in version 9, there has been many customers interested in implementing this API on its own and in tandem with the Ektron e-commerce server controls. The example presented below is for working with an e-commerce Basket Manager.  Re...

  • Binding Default Search Button with Ektron Form Control
    DescriptionThe formblock control takes the default button on a template which is undesired behavior when a search box and button need to have priority. ResolutionThe sample code here will demonstrate the ability to bind the default button to the search and steal it from the formblock.

  • Blog Strategy Sample Extension
    DescriptionThis sample demonstrates the use of Ektron CMS Extensions and Blog APIs.  It will fire off events for the addition of a blog post or blog comment. It will send an email to users who are subscribed to a blog or a blog post.  Default tokens and sample email messages are built into the e...

  • Blog Subscription Tests Template
    DescriptionThis sample allows user to add,  get, and remove subscriptions to a Blog.  This sample also allows user to add a post to a blog or add a comment to an existing post. ResolutionCode Download

  • Blog Test Template
    DescriptionSample test template of a blog server control.ResolutionCode Download Your query string should look like blogtest.aspx?id=x where x = the blog id   

  • See all 75 articles
  • Search


  • Critical Steps when Upgrading Ektron's Solr to 6.2.0 for Ektron version 9.2
    Description If you do not follow the steps below when upgrading to Solr 6.2 - used by Ektron 9.2 - you may see this error when registering a site.  Oops! Something went wrong... A preliminary status check for the search environment has failed. The most common reasons for this are that the...

  • Ektron Solr Node Status Error – Node Status isn’t able to communicate to the Admin Service
    Description The Node Status page in the workarea shows an error: "No response was received while attempting to contact the Ektron Solr Search Admin service." Note: This will affect all customers using 9.2 versions of Solr if the latest cumulative site update has not been applied. ...

  • Incremental crawls failing after syncs on 9.2
    Description In 9.2 if incremental crawls are failing to run after a sync and you see the below error in the EktronWindowsService\Log folder(see KB for enabling logging), see the resolution for the fix.    PM>TID:14|VI+27D8941DEFD0+PHX9.0+07032017+5.21.08.AM||SYSTEM|error|ESyncSearchStrat...

  • $DateModified and $ShortDateModified returned by the WebSearch Server control are displaying current time.
    DescriptionThe WebSearch server control does not display the correct DateModified for the content returned in the results. ResolutionThis is a known issue and the current workaround is to use the SiteSearch Templated Server Control. We have a sample of using the templated search control o...

  • 'Specified cast is not valid' error on Search Configuration page
    DescriptionError:  There was an error received from the Ektron Solr Search Admin service while attempting to retrieve the status of the Solr Core corresponding to your CMS site.  There was an error reading crawl flags from the CMS database corresponding to Core xxxxxx . Specified cast is no...

  • A connection to the CMS database could not be opened
    DescriptionWhen registering your CMS site with Solr you may encounter the following error:A connection to the CMS database could not be opened with the connection string that was provided. Please review it and try again. Logs are available for this console and for the Ektron Solr Administrati...

  • See all 138 articles
  • Security


  • Finding The Security Update Log File
    DescriptionThis article explains how to find the log file for the security patch installer. ResolutionLog into the webserver and navigate to the drive where the site is installed on. Go to this directory.  C:/Program Files (x86)/Ektron/SecurityUpdate/Look for the Results.html file and op...

  • Heartbleed Vulnerability
    DescriptionEktron is taking the Heartbleed vulnerability very seriously and want to keep you all informed of how this impacts you. Below is a description of what the vulnerability is, what it can effect, and how to mitigate intrusions due to this vulnerability. Ektron sites use IIS and so are ...

  • How To Add HttpOnly Flag To The ECM Cookie
    DescriptionThis article describes the Ektron configuration option for setting the HttpOnly flag for the ECM Cookie.ResolutionIn the web.config you will find the following key <!-- This is for setting the HttpOnly attribute for the ECM cookie --><add key="ek_HttpOnly" value=&qu...

  • How to configure a self-signed SSL certificate with Ektron
    DescriptionThis article shows you how to configure a self-signed certificate to test the Workarea in SSL or troubleshoot an SSL issue. A self-signed certificate can help you find a feature that works in HTTP, but not HTTPS. ResolutionThe following linked article outlines the steps to create...

  • How to encrypt the ecm cookie
    DescriptionThis article explains how to encrypt the ecm cookie. ResolutionTo encrypt the ecm cookie 1)  Edit web.config.Changeto 2) Recycle the application pool for the website.

  • HTTPONLY flag not set in Internet Explorer
    Description After having set ek_HttpOnly to true in the web.config you may not see the HTTPONLY flag in Internet Explorer's F12 Developer Tools. Resolution This is an issue with how older versions of IE display if a cookie is set to HTTPOnly and other methods should be used to ver...

  • See all 9 articles
  • Troubleshooting


  • Basic Troubleshooting
    DescriptionWhen adding content and something goes wrong, there are some basic troubleshooting steps you can do in order to dertermine if an error is caused by Ektron, your code, or your database. You will want to test using a clean Page Builder template and/or Content Block template,create a Min...

  • Change the Logging Level in the CMS
    DescriptionTo troubleshoot some issues, support may request that you change your logging level in the web.config to trap extra errors that may be occurring on your website. Below is a list of the various levels and how to change the logging level.ResolutionThe log level key is changed in the web...

  • Data at the root level is invalid. Line 1, position 1. Error when uploading to library
    DescriptionWhen trying to upload an image to the Library, you may get an error of "Data at the root level is invalid. Line 1, position 1. "   Often this is caused by invalid XHTML being handled, but sometimes it can be due to your configuration. CauseYou may have an incorrect setting i...

  • Ektron Log Collector
    DescriptionThe log collector helps to gather information quickly and easily to troubleshoot issues with support for all issue types but is most useful for eSync and Solr. When you run into an issue, if you run the log collector it will package up a lot of the necessary information support will r...

  • Failed Request Tracing
    DescriptionWeb pages intermittently result in status errors such as HTTP 400 or 500 but more details are needed. ResolutionFailed Request Tracing can help provide additional information for various web page errors.The steps below describe how to set up Failed Request Tracing.Prerequisite: E...

  • How to Check the Application Event Log for Errors
    DescriptionWhen you troubleshoot issues, you should look in the Application Event Log for errors. This article shows you how. ResolutionMicrosoft TechNet has instructions about How to Check the Application Event Log for Errors . http://technet.microsoft.com/en-us/library/aa997769%28v=exc...

  • See all 13 articles
  • Users


  • Differences between CMS and Membership users
    DescriptionAccess to the Ektron site is handled through the implementation of CMS and Membership users. Below is brief list of differences between our two types of users. More information on both CMS users and Membership users can be found within the documentation appropriate for your version of...

  • Error occurs when you add userdata with same display name or username as a deleted user
    DescriptionUsing the API, when you add membership users (with the same username and display name) that were previoulsy deleted from the CMS, an error occurs. Resolution<%@ Page Language="C#" %> <!DOCTYPE html> <script runat="server"> protected void uxSu...

  • How to manually unlock a user's account and update passwords
    DescriptionA user's account is locked, or a user's password needs to be manually updated. CauseToo many login attempts can lock a user's account. ResolutionNote: If AD (Active Directory) is used on the site, the password is updated through AD as opposed to the Workarea. The account wou...

  • How to update a membership user account to become a CMS user account
    DescriptionCan existing Membership users be converted into CMS users? What's the best way to accomplish that? ResolutionThe simple answer here is that no, membership users cannot be converted into CMS users. The reasoning behind this is that the CMS treats both groups very differently in te...

  • User added with unexpected user type when using Active Directory.
    DescriptionWhen a user is added in to the CMS for the first time via Active Directory Integration, the user is not added as CMS/Membership user respectively. CauseLikely reasons for this problem are:Incorrect CMS default configuration.Incorrect setting in the Login Server Control.Incorrect ...

  • User custom property values not retrieving in different languages
    DescriptionThe article explains why, in some instances, there is an issue with retrieving the value of a user custom property when using multiple languages. CauseThis occurs because the user custom property is not language-agnostic at this time. The property changes language based on the la...

  • See all 7 articles
  • UX


  • 403 Forbidden: Access is Denied Error after applying a CU or Upgrading
    DescriptionAfter applying the latest CU to 9.1SP1 or upgrading to 9.1 SP2, users can encounter a 403 Forbidden: Access is Denied error in various areas throughout the product. CauseThe issue is caused by a fix implemented in an earlier 9.1SP1 CU and 9.1 SP2. This fix implemented a security ...

  • Access to the Path Error
    DescriptionWhen uploading or overwriting DMS documents or library items, are you experiencing an “Access to the path is denied” error? No need to worry, this is a fairly common error that is usually seen after a new site installation, a site migration, or a new server.  ResolutionThis error...

  • Accessing the workarea in a multisite environment
    DescriptionBest practice for accessing the workarea in a multisite environment.  ResolutionWhen working in a multisite environment, the best practice is to log into a specific site's workarea to make changes, rather than logging into the root site to make changes in a sub site.For example, ...

  • Adaptive Image minimum size
    DescriptionWhat is the minimum file size required for Adaptive Image resizing to occur? ResolutionFiles less than 80 Kb are not resized.  

  • Add button position makes it difficult to add the new node
    DescriptionWhen you add a taxonomy node while in content edit mode, the Add button position is static, which makes it difficult to add the new node to the correct parent taxonomy node if you have to scroll down. ResolutionThis issue was identified and will be addressed in a future release...

  • Alerting the default sort order of workarea listings
    DescriptionWithin version 9.0 series a field was added to the workarea to alter the default sort order of items within the workarea. This option is not present within older versions of the product.ResolutionThe following two keys can be used to alter the field that is  determining the sorting as...

  • See all 97 articles