Manage Hosted Search Pages

The Search Pages page allows members of the Administrators built-in group to manage and host feature-rich search pages in your Coveo organization. These search pages can then be made available to specific groups in an organization.

Hosted search pages rely on the JavaScript Search Framework and can be easily customized using the Interface Editor.

Add a Search Page

  1. On the Search Pages page, click Add Page.

    If the Add Page button is grayed and unresponsive, you don’t have all of the required privileges to perform this action.

  2. In the Add a Search Page panel:

    1. In the Page name box, enter a unique and preferably human-readable path name for your search page.

      This value is used to generate the URL of your search page.

      If your organization ID is mycoveoorganizationg8tp8wu3 and you enter my-search-page as a page name, your search page URL will be:

      https://search.cloud.coveo.com/pages/mycoveoorganizationg8tp8wu3/my-search-page
      
    2. In the HTML title box, enter a human-readable title for your search page.

      As its name implies, the HTML title value populates the HTML <title> element of your search page.

    3. Click Add page.

  3. In the This search page is not configured yet panel, click Set Up a Search Page.

  4. In the Setup a Search Page panel, select the tabs you want to include in your search page. The suggested tabs are based on the content of your index.

    1. (Optional) Click More Tabs to view additional tab options for content types that aren’t yet available in your index.

    2. Click Create Page.

  5. (Optional) Click Edit Search Page.

    1. Use the Interface Editor to customize your search interface.

    2. Click Save to make your changes immediately effective.

  6. (Optional) Ensure that the desired groups are granted access to your search pages.

Customize the Interface of a Search Page

  1. On the Search Pages page, locate and click the search page whose interface you want to edit.

  2. In the Action bar, click Edit Interface.

OR

  1. Access the search page whose interface you want to edit.

  2. In the upper-left corner, click Edit-Search-Page.

You can then use the Interface Editor to customize its layout and functionalities as you see fit.

Grant Access to Search Pages

You can restrict access to search pages in your organization by granting the required privileges to certain groups only.

By default, members of the Users and Administrators built-in groups have access to all search pages in your organization.

  1. Create a new group (or edit a group) that should be granted access to all search pages in your organization.

    Create a Hosted Search Page Users group, and grant it only the minimum required privileges.

  2. Review the privileges granted to your group members to ensure that they minimally have the following privileges.

    Service Name Access level
    Organization Organization View
    Search Execute queries Allowed
    Search Search pages View
  3. Access the “Members” tab of your group and ensure that the group only contains end users who should have access to search pages in your organization.

  4. Validate that members of your group can access search pages in your organization, perform queries, and only see appropriate search results.

  5. Share the search page URL with its intended end users.

    • If you create many hosted search pages targeting different audiences (e.g., employees, customers, partners), make sure permissions are configured appropriately on your sources to prevent disclosing sensitive information (see Content Security). For example, customers should probably not be allowed to see the content of an intranet source.

    • If an SSO is set up for your organization, remember to invite the intended end users of your search pages as users of this SSO so they can access your search pages.

Edit a Search Page

Once a search page has been created, you can edit its name, HTML title, and JS Search Framework version at any time.

  1. On the Search Pages page, locate and click the search page you want to edit.

  2. In the Action bar, click More, and then click Edit.

  3. In the Edit a Search Page panel that appears:

    1. (Optional) In the Page name box, enter a new unique, and preferably human-readable path name for your search page.

      Be aware that changing the page name of an existing search page will update its URL.

      Organization members attempting to access that search page through its previous URL will therefore get a 404 response.

    2. (Optional) In the HTML title box, enter a human-readable title for your search page.

    3. (Optional) Click the Search UI version drop-down menu, and then select the desired JS Search Framework release version for your search page.

      New search pages automatically use the latest available JS Search Framework release version.

      While you can upgrade search pages to more recent versions, you can’t downgrade back to previous versions thereafter.

    4. Click Save.

Delete a Search Page

You can delete an existing search page at any time.

  1. On the Search Pages page:

    1. Locate and click the search page you want to delete.

    2. In the Action bar, click More, and then Delete.

  2. Click Delete to confirm.

    Be aware that the search page will cease being available immediately after you confirm its deletion.

    Organization members attempting to access that search page will therefore get a 404 response.

Access a Search Page

To access a search page in your organization, you can directly navigate to its URL from your browser.

OR

  1. On the Search Pages page, click the search page that you want to access, and then in the Action bar, click Open.

  2. When you’re not already logged in to Coveo Cloud, in the Log in to Coveo Cloud panel, click the identity provider (such as Google, Salesforce, or Office 365) matching the account with which you’re a member of group that has the privileges to access the search pages (see Logging in to a Hosted Search Page).

  3. When you’re not already logged in with the identity provider, in the interface of the identity provider, provide your credentials of an account with which you’re a member of Coveo organization group that has the privileges to access the search pages.

The search page opens in a new browser tab.

Log Out of a Search Page

While in a Coveo Cloud hosted search page, in the upper-right corner of the page, click Log-Out.

The Coveo Cloud login page appears.

Search Page Limitations

Search pages hosted in Coveo organizations have a few noteworthy limitations:

  • The URL of a hosted search page always has the following format:

    https://search.cloud.coveo.com/pages/coveodocumentationtest/{organizationId}/{pageName}

  • A hosted search page can’t be accessed anonymously; its end users must authenticate through the Coveo Platform.

  • It’s impossible to grant access to specific hosted search pages only. A given group can either be granted access to all or none of the hosted search pages in an organization.

  • Component options can’t be set in the init function call of a hosted search page; you must rather pass component options before the init call.

Required Privileges

The following table indicates the privileges required to view or edit elements of the Search Pages page and associated panels (see Manage Privileges and Privilege Reference).

Action Service - Domain Required access level
View search pages

Search - Search pages

View
Edit search pages

Search - Search pages

Edit
Edit and test search pages

Search - Search pages

Edit
Search - Execute queries Allowed

The Edit access level is a sensitive privilege which is typically granted only to administrators. This privilege should remain limited to avoid being exploited by malicious users who could enter unwanted code and put search page users at risk.

Recommended Articles