Skip to content

Add notes about using Painless with cross-project search #5608

Open
marciw wants to merge 5 commits intocps-tech-previewfrom
mw-painless-cps
Open

Add notes about using Painless with cross-project search #5608
marciw wants to merge 5 commits intocps-tech-previewfrom
mw-painless-cps

Conversation

@marciw
Copy link
Contributor

@marciw marciw commented Mar 24, 2026

Summary

see title. Based on a Slack thread and elastic/elasticsearch#138435

See also the corresponding ES reference doc update in elastic/elasticsearch#144895

Screenshots of updated docs

because the docs preview is temporarily unavailable

expand for screenshots:

Details
  1. /explore-analyze/cross-project-search

current page: https://www.elastic.co/docs/explore-analyze/cross-project-search#cps-supported-apis

addition:
Screenshot 2026-03-24 at 6 57 55 PM

  1. /explore-analyze/cross-project-search/cross-project-search-manage-scope

current page: https://docs-v3-preview.elastic.dev/elastic/docs-content/pull/5498/explore-analyze/cross-project-search/cross-project-search-manage-scope#cps-availability

Screenshot 2026-03-24 at 6 46 07 PM
  1. deploy-manage/cross-project-search-config/cps-config-impacts-and-limitations
Screenshot 2026-03-24 at 5 59 07 PM

Generative AI disclosure

  1. Did you use a generative AI (GenAI) tool to assist in creating this contribution?
  • Yes
  • No
    Tool(s) and model(s) used: claude-4.6-opus-high in cursor; cursor composer-2

@marciw marciw marked this pull request as ready for review March 24, 2026 23:00
@marciw marciw requested review from a team as code owners March 24, 2026 23:00
Copy link
Member

@kilfoyle kilfoyle left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM for Admin docs. ⛵


- **User permissions:** {{cps-cap}} results are filtered by each user's role assignments across projects. Users with different roles will see different results from the same query. Refer to [Manage user access](/deploy-manage/cross-project-search-config/cps-config-access-and-scope.md#manage-user-access).

- **{{product.painless}} scripting:** The [{{product.painless}} execute API](/explore-analyze/cross-project-search.md#cps-painless-execute) does not search across linked projects. It resolves index names against the origin project only. You can target a linked project by prefixing the index with the project alias (for example, `projectAlias:myindex`).
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@marciw Out of curiousity, do happen to know where {{product.painless}} is defined? I know that it works, but I'm surprised not to see it in docs-content/docset.yml.

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copy link

@pawankartik-elastic pawankartik-elastic left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

Copy link

@quux00 quux00 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM. Thanks for adding.

Copy link
Collaborator

@shainaraskas shainaraskas left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

beaut

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants