---
title: "Troubleshooting"
slug: "troubleshooting"
abstract: "Fix common errors in the console or terminal related to the Content SDK."
---
# Troubleshooting

This topic describes the most common errors in the console or terminal, and solutions when using the Sitecore Content SDK.

## IE errors

IE errors are related to initialization. You must resolve these errors for the Content SDK to function properly.

<table style="width:100%;" class="informaltable frame-void rules-rows"><thead><tr><th class="th"><p>Code</p></th><th class="th"><p>Description</p></th><th class="th"><p>Solution</p></th></tr></thead><tbody><tr><td class="td"><p><code class="code">IE-001</code></p></td><td class="td"><p>A required plugin dependency is missing.</p></td><td class="td"><p>Review the plugins passed to <code class="code">initContentSdk()</code> and ensure all required dependencies for the plugin are included in the <code class="code">plugins</code> array.</p></td></tr><tr><td class="td"><p><code class="code">IE-002</code></p></td><td class="td"><p>An SDK feature was invoked before initialization.</p></td><td class="td"><p>Ensure that <code class="code">initContentSdk()</code> is executed before calling any SDK functionality that depends on <a class="link linktype-component" href="https://doc.sitecore.com/sai/en/developers/content-sdk/20/initializing-tracking,-events,-and-personalization-in-the-content-sdk.html" title="Initializing tracking, events, and personalization in the Content SDK">initialization</a>. Confirm that proper configuration and plugins are provided.</p></td></tr><tr><td class="td"><p><code class="code">IE-003</code></p></td><td class="td"><p>Timeout exceeded. The server did not respond within the allotted time.</p></td><td class="td"><p>This error occurs when you call a function with the timeout attribute in one of the function parameters, then the function makes a network request to the server, but the server doesn't respond in time. When you use timeout, use try-catch blocks to handle errors.</p></td></tr><tr><td class="td"><p><code class="code">IE-004</code></p></td><td class="td"><p>A feature requiring a specific plugin was used, but the plugin is not registered.</p></td><td class="td"><p>Check the <code class="code">initContentSdk()</code> call and verify that the plugin is included in the <code class="code">plugins</code> array.</p></td></tr><tr><td class="td"><p><code class="code">IE-005</code></p></td><td class="td"><p>Unable to set the <code class="code">sc_cid</code> cookie because the client ID could not be retrieved from the server.</p></td><td class="td"><p>Verify the values for <code class="code">contextId</code> and <code class="code">siteName</code>. If the issue persists, try again later or use try-catch blocks to handle this error.</p></td></tr><tr><td class="td"><p><code class="code">IE-006</code></p></td><td class="td"><p>Unable to set the <code class="code">sc_cid_personalize</code> cookie because the visitor ID could not be retrieved from the server.</p></td><td class="td"><p>Verify the values for <code class="code">contextId</code> and <code class="code">siteName</code>. If the issue persists, try again later or use try-catch blocks to handle this error.</p></td></tr><tr><td class="td"><p><code class="code">IE-007</code></p></td><td class="td"><p>The system failed to resolve a site configuration for the provided host name.</p></td><td class="td"><p>Review site resolution settings in Sitecore AI and ensure that the correct host name mapping is configured.</p></td></tr></tbody></table>

## IV errors

IV errors are related to incorrect values and wrongly formatted objects.

<table style="width:100%;" class="informaltable frame-void rules-rows"><thead><tr><th class="th"><p>Code</p></th><th class="th"><p>Description</p></th><th class="th"><p>Solution</p></th></tr></thead><tbody><tr><td class="td"><p><code class="code">IV-001</code></p></td><td class="td"><p>The provided <code class="code">edgeUrl</code> is missing or not a valid absolute URL.</p></td><td class="td"><p>Verify the Sitecore Edge URL configured via environment variables or in <code class="code">sitecore.config</code>. Ensure it is a valid URL</p></td></tr><tr><td class="td"><p><code class="code">IV-002</code></p></td><td class="td"><p>The provided <code class="code">timeout</code> value is invalid.</p></td><td class="td"><p>Verify the value for <code class="code">timeout</code>. Set the value to an integer greater than or equal to 0.</p></td></tr><tr><td class="td"><p><code class="code">IV-003</code></p></td><td class="td"><p>The provided value for <code class="code">dob</code> is invalid.</p></td><td class="td"><p>Verify the value for <code class="code">dob</code>. Format the value according to <a class="link" href="https://www.iso.org/iso-8601-date-and-time-format.html" target="_blank" rel="noopener">ISO 8601</a>.</p></td></tr><tr><td class="td"><p><code class="code">IV-004</code></p></td><td class="td"><p>The provided value for <code class="code">email</code> is invalid.</p></td><td class="td"><p>Verify the value for <code class="code">email</code>. Set it to a valid email address.</p></td></tr><tr><td class="td"><p><code class="code">IV-005</code></p></td><td class="td"><p>The provided value for <code class="code">expiryDate</code> is invalid.</p></td><td class="td"><p>Verify the value for <code class="code">expiryDate</code>. Format the value according to <a class="link" href="https://www.iso.org/iso-8601-date-and-time-format.html" target="_blank" rel="noopener">ISO 8601</a>.</p></td></tr><tr><td class="td"><p><code class="code">IV-006</code></p></td><td class="td"><p>The number of attributes provided to <code class="code">extensionData</code> exceeds the maximum allowed value.</p></td><td class="td"><p>Verify the number of attributes on <code class="code">extensionData</code>. Reduce the number of attributes.</p></td></tr><tr><td class="td"><p><code class="code">IV-007</code></p></td><td class="td"><p>The specified site cannot be found or its root item tree is not available.</p></td><td class="td"><p>Verify that the site name is correctly defined in environment variables. Confirm that the site exists and is properly configured in SitecoreAI. If the configuration appears correct and the issue persists, contact Sitecore Support.</p></td></tr></tbody></table>

## MV errors

MV errors are related to missing values.

<table style="width:100%;" class="informaltable frame-void rules-rows"><thead><tr><th class="th"><p>Code</p></th><th class="th"><p>Description</p></th><th class="th"><p>Solution</p></th></tr></thead><tbody><tr><td class="td"><p><code class="code">MV-001</code></p></td><td class="td"><p>A required <code class="code">contextId</code> value was not provided.</p></td><td class="td"><p>Ensure that <code class="code">contextId</code> is defined via environment variables or in <code class="code">sitecore.config</code>.</p></td></tr><tr><td class="td"><p><code class="code">MV-002</code></p></td><td class="td"><p>The <code class="code">siteName</code> parameter was not provided or could not be resolved.</p></td><td class="td"><p>Verify that the site name is correctly resolved and passed to the relevant service or configuration.</p></td></tr><tr><td class="td"><p><code class="code">MV-003</code></p></td><td class="td"><p><code class="code">identifiers</code> is required.</p></td><td class="td"><p>Ensure site visitors have valid identifiers. See <a class="link" href="https://github.com/Sitecore/content-sdk/blob/v2.0.0/packages/events/src/events/identity/identity-event.ts#L132" target="_blank" rel="noopener">IdentityData</a>.</p></td></tr><tr><td class="td"><p><code class="code">MV-004</code></p></td><td class="td"><p><code class="code">friendlyId</code> is required.</p></td><td class="td"><p>Friendly ID is the unique identifier of the live interactive experience or experiment to run. Ensure it's a valid friendly ID. See <a class="link" href="https://github.com/Sitecore/content-sdk/blob/v2.0.0/packages/personalize/src/personalization/personalizer.ts#L170" target="_blank" rel="noopener">PersonalizeData</a>.</p></td></tr><tr><td class="td"><p><code class="code">MV-005</code></p></td><td class="td"><p>The <code class="code">sitecore.cli.config</code> file is missing a required property.</p></td><td class="td"><p>Review the <code class="code">sitecore.cli.config</code> documentation and ensure all mandatory properties are defined.</p></td></tr><tr><td class="td"><p><code class="code">MV-006</code></p></td><td class="td"><p>The <code class="code">clientContextId</code> was not provided, which may impact certain client-side features.</p></td><td class="td"><p>Set the Sitecore client context ID if using client-side features that require it (for example, Forms, Events).</p></td></tr><tr><td class="td"><p><code class="code">MV-007</code></p></td><td class="td"><p>Required API configuration is incomplete. Provide either <code class="code">contextId</code> or both <code class="code">apiHost</code> and <code class="code">apiKey</code>.</p></td><td class="td"><p>Ensure that either: <code class="code">contextId</code> is configured, or both <code class="code">apiHost</code> and <code class="code">apiKey</code> are provided. Review environment variables or <code class="code">sitecore.config</code> to confirm one valid configuration path is defined.</p></td></tr><tr><td class="td"><p><code class="code">MV-008</code></p></td><td class="td"><p>The <code class="code">sitecore.config</code> reference is missing or not properly imported.</p></td><td class="td"><p>Ensure that <code class="code">sitecore.config</code> is defined, correctly imported, and passed to the relevant initialization or service layer.</p></td></tr><tr><td class="td"><p><code class="code">MV-009</code></p></td><td class="td"><p>The required <code class="code">language</code> parameter was not provided.</p></td><td class="td"><p>Verify that the language is correctly resolved (for example, from route, context, or configuration) and passed to the related services.</p></td></tr></tbody></table>