Sandbox release disclaimer: Some content in this article outlines how to use functionalities that will be publicly released to all clients at the end of April 2026. If you see differences between this article and your platform, check back at that time. Learn more about the release cycle.

Introduction

Harmony is Docebo's conversational AI experience. It brings together two features that are enabled and configured independently:

• Harmony search — allows all platform users to ask questions, discover content, and perform keyword searches in a unified panel.
• Harmony copilot — provides contextual platform guidance, step-by-step instructions, and administrative support for Superadmins and Power Users.

Harmony is available in all the platform-supported languages and is continuously evolving. Keep an eye on the Product updates page for newly supported capabilities.

This article explains how to enable and configure both features. They are enabled independently from the Artificial Intelligence panel in the Admin menu. For information on how users interact with Harmony once it is enabled, see Harmony.

Harmony search

Prerequisites

Doceboai.cloud domains

For the Harmony search page to load correctly, your firewall or network infrastructure must not be blocking the *.doceboai.cloud domains. Check with your IT department to ensure that *.doceboai.cloud domains are placed on the allow list.

Enable Harmony search

To enable Harmony search, select Admin menu > Artificial Intelligence > Manage to open the Artificial intelligence setup page and locate the Harmony search card. This will indicate whether the functionality is currently: 

• Disabled: the platform has only the legacy global search
• Enabled for all users: the new experience is active for all users of the platform
• Preview mode: enabled only for you, but not visible to other users of the platform 

To enable the feature, on the card click Configure. Then in the Harmony search configuration page, select the check box Enable Harmony search. Then select whether you want to Enable only for me (to test the feature first, before making it available to everyone) or Enable for all users.

When enabled, under General knowledge: 

• Select the check box Allow general AI knowledge in responses to allow Harmony to fall back to its built-in generic knowledge (based on its training data) when it cannot find a relevant answer from the platform’s indexed content
• Deselect this check box to restrict Harmony responses to the indexed platform content only. 

Next, under Catalog content: 

• Select the check box Allow catalog content in responses to let AI answers also draw from free courses and learning plans available to the user for self-enrollment, even if the user is not yet enrolled. 
• Deselect this check box to restrict Harmony responses only to courses or learning plans in which the user is actively enrolled. 

For more information, see the chapter User-visible content for AI chat.

When you are ready, click Save changes. A dialog box will open, warning you that the platform needs to reload to apply the changes. Click Confirm and reload to proceed.  

Switch between Preview and All users mode

If you later want to switch from Preview to All users mode or vice versa:

• In the Artificial Intelligence settings page click Configure on the Harmony search card again.
• Leave the Enable Harmony search check box selected and set the desired option (Enable only for me or Enable for all users) 

Click Save changes and, in the dialog box that opens, click Confirm and reload. 

Disable Harmony search

To disable Harmony search altogether:

• In the Artificial Intelligence settings page click Disable on the Harmony search card.
• In the dialog box that opens, click Confirm and reload. 

Please note: Disabling Harmony search will revert the platform to the legacy global search. Both the Harmony AI chat and the new search results experience will be removed. 

Harmony search on extended enterprise

On extended enterprise platforms, you have the option of enabling or disabling Harmony search selectively, only on specified domains. 

To access the configuration:

1. Select Admin menu > Extended enterprise > Manage
2. In the list, locate the extended enterprise client of interest and click the gear icon on its row. This will open the settings page for that client.
3. In the vertical navigation, select Artificial intelligence and locate the Custom settings option.

Client without custom settings:

If a client has the Custom settings check box de-selected, then the settings of the main platform will apply. Accordingly, these clients will inherit the same Harmony search enablement (Enabled for all users, Disabled, or Preview mode) and options (Allow general AI knowledge, Allow catalog content in responses) that you have configured on the main platform.

Client with custom settings:

On the other hand, for an extended enterprise client that has Custom settings enabled, you can enable or disable Harmony search independently of the root platform. Specifically, in the Harmony search options you can choose: 

• Enable Harmony search for all users: Select this check box to enable the feature for all users on this client, even if it is disabled or in Preview mode on the main platform. 
  When enabled you can also set whether to Allow general AI knowledge in responses  and Allow catalog content in responses on this client.
• Deselect the check box Enable Harmony search for all users to disable the feature for all users on this client, even if it is enabled on the main platform. 
  →Note, however, that if you enabled Preview mode on the main platform, Harmony search will continue to be visible, only to you, also on this client.  For more information see the chapter Preview mode and extended enterprise.

Preview mode and extended enterprise

Preview mode of Harmony search can only be enabled on the main platform. When you enable it there, the Harmony search will be visible only to you in: 

• The main platform
• Extended enterprise clients without Custom settings for Artificial intelligence
• Extended enterprise with Custom settings for Artificial intelligence, and Harmony search disabled

→ However,  on extended enterprise clients with Custom settings for Artificial intelligence, and Harmony search enabled, Harmony search will be visible to everyone, even if it is in Preview mode on the main platform. 

Note on Harmony search modes: 
Preview mode—where Harmony search is enabled only for you—is a client-side setting stored in your browser. If you clear cache/cookies, open an incognito window, switch browsers, or sign in from a different device, the preview flag is removed. In those cases, the platform reverts to the legacy search bar, and the Harmony search option in Artificial Intelligence settings will be reset to Disabled.  
→ When Harmony search is enabled for all users, however, the setting is persistent and does not depend on your browser.

Harmony copilot

Enable the Harmony copilot

To enable the Harmony copilot, select Admin menu > Artificial intelligence > Manage to open the Artificial Intelligence setup page and locate the Harmony copilot card. This will indicate whether the functionality is currently: 

• Disabled: The Harmony copilot is not available.
• Enabled for all administrators: The Harmony support agent is active for all the platform’s Superadmins.
• Preview mode: enabled only for you, but not visible to other users of the platform.

To enable the feature, on the card click Configure. In the Harmony copilot configuration page, select the checkbox Enable Harmony copilot, then select whether you want to Enable only for me (Preview mode) or Enable for all administrators.

IMAGE
When you are ready, click Save changes. A dialog box will open, warning you that the platform needs to reload to apply the changes. Click Confirm and reload to proceed. 

Switch between Preview and All administrators mode

If you later want to switch from Preview to Enable for all administrators mode or vice versa:

• In the Artificial Intelligence settings page, click Configure on the Harmony copilot card again.
• Leave the Enable Harmony copilot checkbox selected and set the desired option (Enable only for me or Enable for all administrators).

Click Save changes and, in the dialog box that opens, click Confirm and reload. 

Disable Harmony copilot

To disable the Harmony copilot for all administrators:

• In the Artificial Intelligence settings page, click Disable on the Harmony copilot card.
• In the dialog box that opens, click Confirm and reload. 

Granting Harmony copilot access to Power Users

As a Superadmin, you can grant Power Users access to Harmony copilot by adding the Harmony copilot permission to their Power User profile.

Once this permission is assigned, all Power Users associated with that profile will see the Harmony icon in the platform header and can open and interact with the copilot.

For more information on how to assign permissions to Power User profiles, see Creating and managing Power Users.

Harmony Copilot on extended enterprise

On extended enterprise platforms, you have the option of enabling or disabling Harmony copilot selectively, only on specified domains. 

To do this:

1. Select Admin menu > Extended enterprise > Manage
2. In the list, locate the extended enterprise client of interest and click the gear icon on its row. This will open the settings page for that client.
3. In the vertical navigation, select Artificial intelligence and locate the Custom settings option.
4. If a client has the Custom settings check box deselected, then the settings of the main platform will apply. Accordingly, these clients will inherit the same Harmony copilot settings (Enabled for all administrators, Disabled, or Preview mode) that you have configured on the main platform.
5. On the other hand, for an extended enterprise client that has Custom settings enabled, you can enable or disable Harmony copilot independently of the root platform by checking or unchecking the Enable Harmony copilot for all administrators option.
   Please note. If you enabled Preview mode on the main platform, Harmony copilot will continue to be visible, only to you, also on this client.  For more information, see the chapter Preview mode and extended enterprise.

Preview mode and extended enterprise

The preview mode of Harmony Copilot can only be enabled on the main platform. When you enable it there, the Harmony copilot will be visible only to you in: 

• The main platform.
• Extended enterprise clients without Custom settings for Artificial intelligence.
• Extended enterprise with Custom settings for Artificial intelligence, and Harmony copilot disabled.

On extended enterprise clients with Custom settings for Artificial intelligence, and Harmony copilot enabled, Harmony copilot will be visible to everyone, even if it is in preview mode on the main platform. 

Note on Harmony Copilot modes

Preview mode, where Harmony Copilot is enabled only for you, is a client-side setting stored in your browser. If you clear cache/cookies, open an incognito window, switch browsers, or sign in from a different device, the preview flag is removed. In those cases, Harmony Copilot is disabled.  

When Harmony Copilot is enabled for all administrators, however, the setting is persistent and does not depend on your browser.