Link and manage projects for cross-project search
This page explains how to link Elastic Cloud Serverless projects for cross-project search, manage your linked projects, and unlink projects you no longer need to search across.
For an overview and prerequisites, refer to Configure cross-project search.
Before linking projects, review the architecture patterns to choose the right linking topology for your organization.
To link projects, use the cross-project search linking wizard in the Elastic Cloud UI:
On the home screen, find the project you want to use as the origin project and click Manage.
Use the sidebar to navigate to the Cross-project search page.
Click Link projects. Browse or search for projects to link to the origin project. Only compatible projects appear in the project list. You can filter by type, cloud provider, region, and tags.
Select the checkbox for each project you want to link. You can link up to 20 projects per origin project.
If a project you expected to link to is missing from the list, it might not be compatible with the origin project.
Complete the remaining steps in the wizard to review and save your selections. In the last step, you can click View API request to see the equivalent API request for linking to the selected projects.
After you link projects, all searches from the origin project query data from every linked project by default. This applies immediately to all queries, including those from existing dashboards and alerting rules.
To limit searches, you can configure a default cross-project search scope for each space. Users can override the default by setting scope on a per-query basis.
On the origin project's Cross-project search page, you can reconfigure cross-project search as needed:
- Link additional projects: Click Link projects to add more linked projects, up to the 20-project maximum per origin project.
- Unlink projects: Remove connections by unlinking projects.
- Open space settings in Kibana: Click Manage spaces to set or adjust the default CPS scope for the space.
To remove a linked project from the current CPS configuration, navigate to the Cross-project search page. Select the checkbox next to the projects you want to disconnect, then click Unlink.
After you confirm, searches from the origin project will no longer include data from the unlinked projects.
You can't delete a project that's linked to an origin project. To delete a linked project, first unlink it from every origin project it's connected to, then delete it.