---
title: Override the search friendly error message
slug: '2402'
canonical_url: https://docs.coveo.com/en/2402/
collection: coveo-for-sitecore-v5
source_format: adoc
---
# Override the search friendly error message
> **Legacy feature**
>
> The Coveo Hive Framework is now in maintenance mode and is no longer recommended for new implementations.
> 
> To build new search experiences, use one of Coveo's more modern, lightweight, and responsive libraries.
> To get started, see the [Build search](https://docs.coveo.com/en/2473/) article.

If a critical error occurs when rendering the search page, the **Coveo Search Interface** rendering is set to render an error such as the one below, instead of raising an ASP.NET error:

![Screenshot of the Search is currently unavailable message | Coveo](https://docs.coveo.com/en/assets/images/c4sc-v5/36176157.png)

These error captions are stored in Coveo for Sitecore dictionaries in the Sitecore Content Editor.
This article explains how you can override them with your own dictionary entries.

> **Important**
>
> Don't store custom `Dictionary entry` items in the `/sitecore/system/Dictionary/Coveo Hive` folder as this folder is overwritten when upgrading Coveo for Sitecore.

## Step 1: Create a Dictionary for Your Custom Labels

. Open the Sitecore **Content Editor**.
. Navigate to `/sitecore/system/Dictionary`.
. Select the **Dictionary** item, then right-click it and select **Insert** > **Dictionary folder**.
. Name your dictionary.
For this example, you can name it `Custom`.

## Step 2: Create the Custom Title Caption

. Select the **Custom** item, right-click it and select **Insert** > **Dictionary entry**.
. Enter a name such as `CustomSearchUnavailableErrorTitle`.
. Fill the **Key** field with the text below.

```text
Search is currently unavailable
```

> **Note**
>
> The text must be exactly as shown above.
> Make sure there are no leading or trailing whitespaces.

. Fill the **Phrase** field with the text you want.

## Step 3: Create the Custom Label for the Detail Message

. Create a new **Dictionary entry** as in step 2.
. Fill the **Key** field with the text below.

```text
If the problem persists contact the administrator.
```

> **Note**
>
> The text must be exactly as shown above.
> Make sure there are no leading or trailing whitespaces.

. Fill the **Phrase** field with the text you want.

## Step 4: Add Your Custom Dictionary to the List of Additional Dictionaries

You must tell Coveo for Sitecore where to look for your custom dictionary entries.
You do this in the [Coveo Search Resources](https://docs.coveo.com/en/3033#data-source-options) rendering data source.

. In the Experience Editor, select the **Coveo Search Resources** rendering.
You usually need to scroll to the very bottom of the page to locate it.

. In the floating toolbar, select the **Edit the rendering's data source** option.
It should be the leftmost option in the toolbar.

. Under **Additional Dictionaries**, select your `Custom` dictionary folder.

![Adding a custom dictionary folder to the Additional Dictionaries | Coveo for Sitecore 5](https://docs.coveo.com/en/assets/images/c4sc-v5/adding-to-additional-dictionaries.png)

> **Note**
>
> Coveo for Sitecore reads the **Additional Dictionaries** list from top to bottom.
> Dictionary entries with the same **Key** are successively overridden and the last entry is applied in the search interface.

. Publish all your changes.

The friendly error messages are now overridden.

![Screenshot of the custom Coveo Search Interface error message  | Coveo](https://docs.coveo.com/en/assets/images/c4sc-v5/36176158.png)