Manage Hosted Search Pages

The Search Pages page allows you to create search interfaces hosted by Coveo. Coveo-hosted search pages are immediately fully operational, which means that you can use and share them as soon as they’re created.

The instructions on this page pertain to the hosted pages created with the search interface builder or with the classic search page option. If you rather choose to develop your own search interface, you should rather explore the documentation of your approach of choice. Moreover, search pages created with Coveo’s libraries aren’t hosted by Coveo. You must therefore host them yourself.

Create a Hosted Search Interface

The Search Pages page offers three ways to create a search interface.

Depending on your goal and coding skills, you can use:

  • The search interface builder, which allows you to create a simple search page in a couple minutes. No coding skills are required. Coveo hosts the search pages created with the builder.

  • The classic Interface Editor option, which relies on the JavaScript Search Framework. We typically recommend using this option only when instructed to by the documentation. Coveo also hosts classic search interfaces. If you choose this option, see Classic Search Page.

  • One of the developer approaches, which include the Atomic library. These approaches require coding skills, but allow more fine-tuning than the builder and Interface Editor. You’re responsible to host the search page you create.

For further information on these options, see Choose the Right Approach.

Classic Search Page

The classic Interface Editor relies on the JavaScript Search Framework. We typically recommend using this option only when instructed to by the documentation.

  1. In the Add a Search Page panel:

    1. In the Page name box, enter a unique path name for your search page.

    2. In the HTML title box, enter a title for your search page.

    3. In the Access tab, ensure that the desired groups are granted access to your search page.

    4. Click Add page.

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

  3. 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.

  4. Click Create Page.

  5. To edit your search page, click the pencil in the upper-left corner. See the reference documentation for details on how the Interface Editor works.

  6. Click Save to make your changes immediately effective.

Edit a Hosted Search Interface

You can always go back to the search interface builder to edit a search interface.

Alternatively, if you used the classic Interface Editor to create your search interface, see Edit a Classic Hosted Search Page instead.

On the Search Pages page:

  1. Click the search interface you want to edit.

  2. In the Action bar, click Edit.

Alternatively, from the desired search interface, click Cog icon to builder in the upper-right corner.

Edit a Classic Hosted Search Page

You can always go back to the Interface Editor to edit a search interface.

Alternatively, if you used the search interface builder to create your search interface, see Edit a Hosted Search Interface instead.

On the Search Pages page:

  1. Click the search interface you want to edit.

  2. In the Action bar, click either:

    • Edit to change the page name or HTML title.

    • Edit Interface to edit the page design.

Alternatively, from the desired search page, click Edit-Search-Page.

Delete a Search Page

You can delete an existing search page at any time.

  1. On the Search Pages page:

    1. Click the search page you want to delete.

    2. In the Action bar, click Delete.

  2. Click Delete to confirm.

Once you confirm the deletion, organization members attempting to access that search page will get a 404 error.

Grant Access to a Classic Search Page

You can restrict access to classic search pages in your organization by granting the required privileges to certain groups only. This section doesn’t apply to search pages created with the search interface builder.

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.

“403 Access Denied” Error

If your organization uses more than one SSO authentication scheme, a 403 Access Denied error may appear when attempting to access a hosted search interface. This can occur, for example, when a user is already signed in with an SSO provider that’s not the intended SSO provider for the search interface. To force your search interface to re-authenticate users using the intended SSO provider, append ?forceAuthn=true to the end of the search page URL. Doing so redirects users to the intended SSO provider sign-in page. For example, if your search URL is https://search.cloud.coveo.com/pages/organization/search, use https://search.cloud.coveo.com/pages/organization/search?forceAuthn=true to force re-authentication.

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.

What's Next for Me?