Unknown page for the current site configuration error with Coveo Lightning components

This is for:

Developer System Administrator
In this article

Symptoms

Either when accessing or adding Coveo Lightning components in your community, you get the following error:

Unknown page name for current site configuration
Access the Configuration page installed with the Coveo package

The component fails to render itself apart from the error message, and you’re unable to access the Advanced Configuration settings or the Interface Editor.

Cause

This issue happens when you have many Coveo components in your Experience Cloud site that don’t share the same Advanced Configuration Settings (see Add a server-side Coveo Lightning Aura component configuration).

Resolution

To fix this issue, follow these steps:

  1. In your community, note the name of your components. The default names for the components are communityCoveo and communityCaseCreationCoveo.

  2. Open the Salesforce Developer Console (see Developer Console).

  3. In the Query Editor of the Salesforce Developer Console, perform the following SOQL query:

     SELECT Id, CoveoV2__Configuration__c, CoveoV2__SiteName__c FROM CoveoV2__CoveoLightningSettings__c

  4. In the Query Results, double-click the CoveoConfigurationc element, which should be a JSON, and copy-paste it in your favorite text editor. The JSON should look similar to this:

     {
     "pages": {
         "communityCaseCreationCoveo": {
             "userGroups": [],
             "filter": "",
             "customTokenGeneration": false,
             "anonymousUser": null,
             "additionalUserIdentities": []
         },
         "communityCoveo": {
             "userGroups": [],
             "filter": "",
             "customTokenGeneration": false,
             "anonymousUser": null,
             "additionalUserIdentities": []
         }
     }
 }

  5. Ensure all the settings of your pages are the same.

  6. Ensure that the name of your component is an element of pages. If not, copy-paste one of the elements, and change the page name to your Coveo component. Example where your component name is custom:

     {
     "pages": {
         "custom": {
             "userGroups": [],
             "filter": "",
             "customTokenGeneration": false,
             "anonymousUser": null,
             "additionalUserIdentities": []
         },
         "communityCaseCreationCoveo": {
             "userGroups": [],
             "filter": "",
             "customTokenGeneration": false,
             "anonymousUser": null,
             "additionalUserIdentities": []
         },
         "communityCoveo": {
             "userGroups": [],
             "filter": "",
             "customTokenGeneration": false,
             "anonymousUser": null,
             "additionalUserIdentities": []
         }
     }
 }

  7. Copy-paste the JSON back under CoveoConfigurationc in the Salesforce Developer Console.

  8. Save the new configuration by selecting Save Rows.

Your component should now work properly.