Skip to content

Update Fleet and ingest integration steps for direct Add integration navigation - #9251

Merged
vishaangelova merged 1 commit into
mainfrom
8153-overview-page-links
Nov 6, 2026
Merged

vishaangelova merged 1 commit into
mainfrom
8153-overview-page-links

Conversation

@vishaangelova

@vishaangelova vishaangelova commented Nov 6, 2026 •

Copy link
Copy Markdown
Member

Relates to #8153. Part of a set of PRs for this issue, split by docs set:

  • #9055: the integration policy and agent policy pages, and a new page, Open an integration's details, that other pages link to
  • #9056: Security pages
  • This PR: Fleet and ingest pages
  • #9252: Observability pages

The PRs don't depend on each other and can merge in any order. Close #8153 after all four merge.

Summary

Two UI changes affect the steps for adding an integration:

  • Starting in 9.6 (and in Serverless), selecting an integration tile opens the Add page directly instead of the integration's details page (kibana#299010). This includes the tiles in Observability and Security onboarding, which use the same Fleet card logic.
  • The Ready to add your first integration? page was removed in 9.3.6, 9.4.3, and 9.5.0 (kibana#271801). In earlier releases, it only appears on Elastic Cloud when no agents are enrolled yet, and never for a few integrations with their own setup flow, such as Elastic APM.

How the steps change

  • "Click Add " becomes "If the integration's Overview page opens, click Add ." The next step is the same in every version, so there's no badge.
  • The separate step that asked readers to read the integration's overview is removed on the stack monitoring pages, along with "Make sure you configure all required settings". The steps now match the other pages.
  • "If the Ready to add your first integration? page opens, click Add integration only (skip agent installation)." This step has no applies_to badge on purpose. Even in the releases that still have it, the page only appears under the conditions above, so the step must stay conditional either way. Readers who don't see the page skip the step, and everyone reaches the same configuration page next. A badge would only add noise. Where this step was a tip or note, it's now a numbered step, because readers who see that page can't continue without it.
  • The namespace index template and ILM pages go through the Installed integrations tab to reach the integration's Integration policies tab, because selecting a tile on Browse integrations now opens the Add page instead of the installed integration's pages.
Changes

8 pages: standalone agent policies, the Fleet-managed Kubernetes Helm example, namespace index templates and ILM, enabling a managed integration, Automatic Import, and stack monitoring for Elasticsearch and Kibana.

  • Opening Integrations and finding the tile use the same wording as #9252, following the UI writing guide.
  • Automatic Import: the step's purpose now comes after the conditional, so readers who skip the details page still know to configure the integration and assign it to an agent policy.
  • The agent policies page, the Fleet API docs page, the standalone nginx examples, and Fleet Server on Kubernetes moved to #9055. They either link to its new page, Open an integration's details, or add the integration from an agent policy, which opens a flyout from 9.1.

Not changed: the Elastic GovCloud and Firehose pages, because those integrations still open their details page.

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: Cursor with Claude Opus 5.5

@github-actions

github-actions Bot commented Nov 6, 2026

Copy link
Copy Markdown
Contributor

Elastic Docs AI PR menu

Check the box to run an AI review for this pull request.

  • Review docs changes (docs-review). Status: not started.

Powered by GitHub Agentic Workflows and docs-actions. For more information, reach out to the docs team.

@vishaangelova vishaangelova changed the title Link integration steps to the Overview page section Update Fleet and ingest integration steps for direct Add integration navigation Nov 6, 2026
@vishaangelova
vishaangelova force-pushed the 8153-overview-page-links branch 3 times, most recently from bae9054 to ef76908 Compare November 6, 2026 12:19
@github-actions

github-actions Bot commented Nov 6, 2026

Copy link
Copy Markdown
Contributor

✅ Elastic Docs Style Checker (Vale)

No issues found on modified lines!


The Vale linter checks documentation changes against the Elastic Docs style guide. To use Vale locally or report issues, refer to Elastic style guide for Vale.

vishaangelova added a commit that referenced this pull request Nov 6, 2026
vishaangelova added a commit that referenced this pull request Nov 6, 2026
Co-authored-by: Cursor <cursoragent@cursor.com>
…navigation

Co-authored-by: Cursor <cursoragent@cursor.com>
@vishaangelova
vishaangelova force-pushed the 8153-overview-page-links branch from 5b769e3 to 1f831d1 Compare November 6, 2026 13:32
@vishaangelova
vishaangelova marked this pull request as ready for review November 6, 2026 13:33
@vishaangelova
vishaangelova requested review from a team as code owners November 6, 2026 13:33

@yetanothertw yetanothertw left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

Admin docs changes look good, thank you!

@florent-leborgne florent-leborgne left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

@vishaangelova
vishaangelova added this pull request to the merge queue Nov 6, 2026
Merged via the queue into main with commit 47779cf Nov 6, 2026
20 checks passed
@vishaangelova
vishaangelova deleted the 8153-overview-page-links branch November 6, 2026 18:55
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.

[Internal]: Update references to integration tiles UX

3 participants