Part 1: Update docs for cloud nav redesign by wajihaparvez · Pull Request #8192 · elastic/docs-content

wajihaparvez · 2026-09-03T19:27:35Z

Summary

Updates docs to reflect new nav changes in cloud UI.
Rel docs issue: https://github.com/elastic/docs-content-internal/issues/1766

Side nav reorg

Lots of items in the nav moved around to new sections (listed here). In most cases, I opted to exclude subsections and just document the top-level section > target page (e.g. Organization ~~> Identity and access~~ > Members) to future-proof in case subsections are moved again. The subsections are not clickable in the UI anyway.

Rel cloud UI PR: https://github.com/elastic/cloud-ui/pull/4127

Reset password path (ECH and ECE)

Previously, users could reset their password from their deployment's Security page or Overview > Actions menu. The Security path is going away now.

Rel cloud UI PR: https://github.com/elastic/cloud-ui/pull/4279

Bonus

I found a bunch of ECH/ECE “reset the password” links that pointed to the self-managed built-in users page, which then directed cloud users to the ECH/ECE page (2 steps later). Fixed to point to the ECH/ECE page directly.

Generative AI disclosure

Did you use a generative AI (GenAI) tool to assist in creating this contribution?

Yes: Grok 4.6 in Cursor
No

github-actions · 2026-09-03T19:28:14Z

Elastic Docs AI PR menu

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

Review docs changes (docs-review). Status: queued.

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

github-actions · 2026-09-03T19:30:04Z

🔍 Preview links for changed docs

Elastic Docs Style Checker (Vale)

Summary: 4 warnings found

⚠️ Warnings (4): Fix when the suggestion improves clarity or correctness.

File	Line	Rule	Message
deploy-manage/api-keys/elastic-cloud-api-keys.md	53	Elastic.MenuArrowsBold	Use '→' to separate menu items, not '' or '='. Example: Select Manage index → Add lifecycle policy.
deploy-manage/api-keys/elastic-cloud-api-keys.md	107	Elastic.MenuArrowsBold	Use '→' to separate menu items, not '' or '='. Example: Select Manage index → Add lifecycle policy.
deploy-manage/cloud-organization/billing/update-billing-operational-contacts.md	26	Elastic.MenuArrowsBold	Use '→' to separate menu items, not '' or '='. Example: Select Manage index → Add lifecycle policy.
manage-data/ingest/ingesting-data-from-applications/ingest-data-with-python-on-elasticsearch-service.md	83	Elastic.MenuArrows	Use '→' to separate menu items, not '' or '='. Example: Select Manage index → Add lifecycle policy.

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.

nastasha-solomon

Left a few suggestions for your consideration. Otherwise, lgtm!

nastasha-solomon · 2026-09-08T15:58:55Z

 ::::{tab-set}
 :::{tab-item} Using the {{ecloud}} Console
 1. Log in to the [{{ecloud}} Console](https://cloud.elastic.co?page=docs&placement=docs-body).
-2. Go to your avatar in the upper right corner and choose **Organization**.


If this instruction is still relevant to users on earlier versions of the stack, add applies_to tag. Looks like there's a handful of similar instances across this PR, so flagging it here instead of dropping individual comments throughout.

All these changes are for cloud (serverless, ECH, or ECE) so they don't need stack version scoping

nastasha-solomon · 2026-09-08T16:03:07Z

 1. Log in to the [{{ecloud}} Console](https://cloud.elastic.co?page=docs&placement=docs-body).
-2. Go to your avatar in the upper right corner and choose **Organization**.
-3. On the **API keys** tab of the **Organization** page, click **Create API key**.
+2. From the navigation menu, select **Organization** > **API keys**.


Directing users towards the global search bar is also a good strategy for future-proofing nav-related content. I entered "API keys" into the search bar for a stack deployment and serverless project, and got the same result for both.

Here's one option:

Suggested change

2. From the navigation menu, select **Organization** > **API keys**.

2. From the navigation menu, select **Organization** → **API keys**. You can also search for **API keys** in the [global search bar](/explore-analyze/find-and-organize/find-apps-and-objects.md).

Another, more succint version:

Suggested change

2. From the navigation menu, select **Organization** > **API keys**.

2. Search for **API keys** in the [global search bar](/explore-analyze/find-and-organize/find-apps-and-objects.md).

Normally I'd agree with you, but this change is referring to the org-wide API keys page, not the kibana counterpart. There's no global search on the "manage deployment/project" side, so we have to give exact nav steps :(

nastasha-solomon · 2026-09-08T16:04:26Z

 In {{kib}}, go to **Agent Builder** → **Tools library**, click **Manage MCP**, and select **Manage MCP clients (OAuth)** to confirm the connection count for your client has increased. If you don't see it within a minute of authorizing, refresh the page.

-You can also check your connection in the {{ecloud}} Console at **Organization** → **Security settings** → **Application connections**.
+You can also check your connection in the {{ecloud}} Console at **Organization** → **Application connections**.


Same rec to refer users towards the global search bar.

Application connections doesn't appear thru the global search. You have to go to your cloud home page and then use the side nav because it's a "manage" page

georgewallace

Minor nits and questions.

georgewallace · 2026-09-08T17:49:34Z

@@ -1,2 +1,2 @@
 1. Log in to [{{ecloud}}](https://cloud.elastic.co?page=docs&placement=docs-body).
-2. From the navigation menu, select **Security** > **Network security**. 
+2. From the navigation menu, select **Organization** > **Network security**. 


is this line supposed to be different then the steps in deploy-manage/deploy/elastic-cloud/azure-native-isv-service-troubleshooting.md

I had updated it on the deploy-manage/deploy/elastic-cloud/azure-native-isv-service-troubleshooting.md to match this page but forgot to save it before committing. Thanks for catching!

wajihaparvez added 2 commits September 2, 2026 16:52

initial pass

1c9ef4c

serverless clean up + ece and ech changes

51f52a4

wajihaparvez self-assigned this Sep 3, 2026

wajihaparvez marked this pull request as ready for review September 3, 2026 19:58

wajihaparvez requested review from a team as code owners September 3, 2026 19:58

wajihaparvez requested a review from galaxxyz September 3, 2026 19:58

wajihaparvez added 3 commits September 3, 2026 16:21

revert wrong link changes

3de39bc

Merge branch 'main' into new-nav-serverless

0e2e5da

vale suggestion

f50bdc6

galaxxyz approved these changes Sep 7, 2026

View reviewed changes

Merge branch 'main' into new-nav-serverless

6828dc8

nastasha-solomon approved these changes Sep 8, 2026

View reviewed changes

leemthompo approved these changes Sep 8, 2026

View reviewed changes

georgewallace approved these changes Sep 8, 2026

View reviewed changes

wajihaparvez added 2 commits September 8, 2026 23:18

PR feedback

7cc13ad

Merge branch 'main' into new-nav-serverless

3538755

wajihaparvez enabled auto-merge (squash) September 9, 2026 03:21

wajihaparvez disabled auto-merge September 9, 2026 03:26

fix error

6229c05

wajihaparvez merged commit 0ef10bd into elastic:main Sep 9, 2026
10 checks passed

wajihaparvez deleted the new-nav-serverless branch September 9, 2026 03:31

github-actions Bot deployed to docs-preview September 9, 2026 03:33 View deployment

	2. From the navigation menu, select Organization > API keys.
	2. From the navigation menu, select Organization → API keys. You can also search for API keys in the [global search bar](/explore-analyze/find-and-organize/find-apps-and-objects.md).

	2. From the navigation menu, select Organization > API keys.
	2. Search for API keys in the [global search bar](/explore-analyze/find-and-organize/find-apps-and-objects.md).

Conversation

wajihaparvez commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Summary

Side nav reorg

Reset password path (ECH and ECE)

Bonus

Generative AI disclosure

Uh oh!

github-actions Bot commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Elastic Docs AI PR menu

Uh oh!

github-actions Bot commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

🔍 Preview links for changed docs

Uh oh!

github-actions Bot commented Sep 3, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Elastic Docs Style Checker (Vale)

Uh oh!

nastasha-solomon left a comment

Choose a reason for hiding this comment

Uh oh!

nastasha-solomon Sep 8, 2026

Choose a reason for hiding this comment

Uh oh!

wajihaparvez Sep 9, 2026

Choose a reason for hiding this comment

Uh oh!

nastasha-solomon Sep 8, 2026

Choose a reason for hiding this comment

Uh oh!

wajihaparvez Sep 9, 2026

Choose a reason for hiding this comment

Uh oh!

nastasha-solomon Sep 8, 2026

Choose a reason for hiding this comment

Uh oh!

wajihaparvez Sep 9, 2026 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Choose a reason for hiding this comment

Uh oh!

georgewallace left a comment

Choose a reason for hiding this comment

Uh oh!

georgewallace Sep 8, 2026

Choose a reason for hiding this comment

Uh oh!

wajihaparvez Sep 9, 2026

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

This branch was successfully deployed

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

wajihaparvez commented Sep 3, 2026 •

edited

Loading

github-actions Bot commented Sep 3, 2026 •

edited

Loading

github-actions Bot commented Sep 3, 2026 •

edited

Loading

github-actions Bot commented Sep 3, 2026 •

edited

Loading

wajihaparvez Sep 9, 2026 •

edited

Loading