elastic · florent-leborgne · Apr 30, 2026 · Apr 30, 2026 · Apr 30, 2026 · Apr 30, 2026
@@ -77,6 +77,7 @@ shared_configuration:
 ###
 narrative:
   checkout_strategy: full
+  current: hub-pages
 
 ###
 # 'references' defines a map of `elastic/<repository_name> * <repository_config>

@@ -4266,6 +4266,17 @@ nav:
         - page: docs-content://solutions/security/apis.md
           title: APIs
 
+  - section: Products
+    url: /products/
+    dropdown: true
+    children:
+    - label: Stack products
+      children:
+      - page: docs-content://products/elasticsearch/v9.md
+        title: Elasticsearch
+      - page: docs-content://products/kibana/v9.md
+        title: Kibana
+
   - section: APIs
     url: https://www.elastic.co/docs/api
 

@@ -17,6 +17,7 @@ toc:
   #############
   # NARRATIVE #
   #############
+  - toc: products
   - toc: get-started
   - toc: solutions
   - toc: manage-data

@@ -151,6 +151,7 @@ products:
   elasticsearch:
     display: 'Elasticsearch'
     versioning: 'stack'
+    hub: 'products/elasticsearch/v9'
   elasticsearch-client:
     display: 'Elasticsearch Client'
     versioning: 'stack'
@@ -211,6 +212,7 @@ products:
   kibana:
     display: 'Kibana'
     versioning: 'stack'
+    hub: 'products/kibana/v9'
   logstash:
     display: 'Logstash'
     versioning: 'stack'

@@ -0,0 +1,86 @@
+###
+# Centralized "What's new" feed used by the {whats-new} directive.
+#
+# Any page can render a product's recent highlights with:
+#
+#   :::{whats-new}
+#   :product: kibana
+#   :::
+#
+# The {whats-new} directive looks the product up in this file and renders the
+# full panel (header + items). Authors only edit this file, and the directive
+# stays trivial in markdown.
+#
+# An optional `id` and `badge` per product control the section anchor and the
+# small badge shown to the left of the title. The default badge is "New".
+###
+
+products:
+
+  kibana:
+    title: What's new in Kibana
+    id: whats-new
+    release-links:
+      - label: Stack 9.4.1
+        url: https://www.elastic.co/docs/release-notes/kibana
+      - label: Serverless · Apr 1, 2026
+        url: https://www.elastic.co/docs/release-notes/cloud-serverless
+    upgrade-link:
+      label: Upgrade guide
+      url: https://www.elastic.co/docs/deploy-manage/upgrade/deployment-or-cluster
+    items:
+      - title: Dashboards and visualizations APIs
+        description: Programmatically create and manage dashboards and visualizations, so you can automate reporting and version-control your analytics.
+        link: https://www.elastic.co/docs/api/doc/kibana
+        date: 9.4 preview
+        tag: Dashboards
+        featured: true
+      - title: AI agent skills
+        description: Teach AI coding agents to work with the Elastic stack.
+        link: https://www.elastic.co/docs/explore-analyze/ai-features/agent-skills
+        date: Mar 2026
+        tag: AI Assistant
+      - title: Agent Builder
+        description: Build custom AI agents that reason over your data.
+        link: https://www.elastic.co/docs/explore-analyze/ai-features/elastic-agent-builder
+        date: 9.3 GA
+        tag: AI Assistant
+      - title: Workflows
+        description: Automate tasks with Kibana actions, HTTP calls, and AI agents.
+        link: https://www.elastic.co/docs/explore-analyze/workflows
+        date: 9.3 preview
+        tag: Automation
+
+  elasticsearch:
+    title: What's new in Elasticsearch
+    id: whats-new
+    release-links:
+      - label: Stack 9.4.1
+        url: https://www.elastic.co/docs/release-notes/elasticsearch
+      - label: Serverless · Apr 1, 2026
+        url: https://www.elastic.co/docs/release-notes/cloud-serverless
+    upgrade-link:
+      label: Upgrade guide
+      url: https://www.elastic.co/docs/deploy-manage/upgrade/deployment-or-cluster
+    items:
+      - title: semantic_text field type
+        description: Simplify semantic search. No pipeline setup needed, just define the field and start querying.
+        link: https://www.elastic.co/docs/solutions/search/semantic-search/semantic-search-semantic-text
+        date: 9.4 GA
+        tag: Search
+        featured: true
+      - title: ES|QL improvements
+        description: New functions, cross-cluster support, and dense vector operations directly in ES|QL queries.
+        link: https://www.elastic.co/docs/reference/query-languages/esql/esql-getting-started
+        date: '9.4'
+        tag: Query languages
+      - title: Inference API expansion
+        description: Connect to external AI models for embeddings and reranking.
+        link: https://www.elastic.co/docs/api/doc/elasticsearch/operation/operation-inference-put
+        date: '9.4'
+        tag: AI
+      - title: Breaking changes in 9.x
+        description: Review removed settings, deprecated APIs, and behavioral changes before upgrading from 8.x.
+        link: https://www.elastic.co/docs/release-notes/elasticsearch/breaking-changes
+        date: Upgrade guide
+        tag: Upgrade
@@ -144,6 +144,7 @@ toc:
       - file: applies-switch.md
       - file: automated_settings.md
       - file: buttons.md
+      - file: card-group.md
       - file: changelog.md
       - file: code.md
       - file: comments.md
@@ -153,13 +154,18 @@ toc:
       - file: dropdowns.md
       - file: definition-lists.md
       - file: example_blocks.md
+      - file: explore.md
       - file: file_inclusion.md
       - file: footnotes.md
       - file: frontmatter.md
+      - file: hero.md
+      - file: hub-pages.md
       - file: icons.md
+      - file: get-started.md
       - file: images.md
       - file: videos.md
       - file: kbd.md
+      - file: link-card.md
       - file: math.md
       - file: diagrams.md
       - file: lists.md
@@ -168,6 +174,7 @@ toc:
       - file: storybook.md
       - file: links.md
       - file: list-sub-pages.md
+      - file: on-this-page.md
       - file: page-card.md
       - file: passthrough.md
       - file: sidebars.md
@@ -179,6 +186,7 @@ toc:
       - file: tabs.md
       - file: tagged_regions.md
       - file: titles.md
+      - file: whats-new.md
   - cli: cli-schema.json
     folder: cli
     children:
@@ -213,6 +221,14 @@ toc:
   - folder: testing
     children:
       - file: index.md
+      - folder: products
+        children:
+          - folder: elasticsearch
+            children:
+              - file: v9.md
+          - folder: kibana
+            children:
+              - file: v9.md
       - file: kibana-settings-yaml-samples.md
       - file: security-settings.md
       - file: req.md

@@ -0,0 +1,47 @@
+# Card group
+
+A section heading + a card grid container. Wraps one or more [`{link-card}`](link-card.md) directives.
+
+## Basic
+
+```markdown
+::::{card-group}
+:title: Install and administer
+:id: install
+
+:::{link-card}
+title: Self-managed
+link: /deploy/self-managed
+description: Run on your own infrastructure.
+links:
+  - { label: Docker, url: /deploy/docker }
+:::
+
+:::{link-card}
+title: Elastic Cloud Hosted
+link: /deploy/cloud
+description: Managed deployments on AWS, GCP, or Azure.
+:::
+::::
+```
+
+The outer fence uses **four** colons (`::::`) so the inner three-colon `:::` fences for the cards aren't interpreted as a closing fence. Use as many extra colons on the outer fence as you need to nest cleanly.
+
+## Options
+
+| Option | Notes |
+|---|---|
+| `:title:` | H2 heading. Optional — without it, only the grid renders. |
+| `:intro:` | Optional intro paragraph below the heading. |
+| `:id:` | Section anchor. Picked up by [`{on-this-page}`](on-this-page.md). |
+| `:variant:` | Optional layout variant. Set to `solutions` to lock a 3-up grid that steps down to 2 then 1 column and tolerates a fourth card without shrinking into a narrow fourth column. |
+
+## Layout
+
+By default the grid auto-fills 1, 2, or 3 columns based on viewport width using `grid-template-columns: repeat(auto-fill, minmax(310px, 1fr))`. Card heights match within a row.
+
+With `:variant: solutions`, the grid is locked to three equal columns (two below 980px, one below 640px). A fourth card wraps to the next row rather than compressing the layout.
+
+## Inside `{explore}`
+
+When a card-group sits inside an [`{explore}`](explore.md) section, it renders as a collapsible **accordion group** instead of a titled grid: the `:title:` becomes the accordion header and the child [`{link-card}`](link-card.md)s render as link columns. No extra options are needed — the `{explore}` ancestor drives the change.
@@ -0,0 +1,74 @@
+# Explore
+
+The **Explore {product}** section of a [hub page](hub-pages.md): a titled band that
+houses a stack of collapsible **accordion groups**. It wraps one or more
+[`{card-group}`](card-group.md) directives. Inside `{explore}`, each card-group
+renders as an accordion and each [`{link-card}`](link-card.md) renders as a titled
+link **column** instead of a bordered card.
+
+The first accordion in the stack is expanded by default, and the rest are collapsed.
+Toggling uses native `<details>`/`<summary>`, so it works without JavaScript.
+
+## Basic
+
+```markdown
+:::::{explore}
+:title: Explore Kibana
+:intro: Explore the apps and capabilities that help you act on your data.
+
+::::{card-group}
+:title: Install & admin
+:id: install
+
+:::{link-card}
+title: Self-managed
+link: /deploy-manage/deploy/self-managed
+links:
+  - { label: Docker, url: /deploy/docker }
+  - { label: Configure, url: /deploy/configure }
+aside:
+  label: Even more
+  links:
+    - { label: RPM, url: /deploy/rpm }
+    - { label: Windows, url: /deploy/windows }
+:::
+::::
+
+::::{card-group}
+:title: Visualize & analyze
+:id: visualize
+
+:::{link-card}
+title: Dashboards
+link: /explore-analyze/dashboards
+links:
+  - { label: Create a dashboard, url: /dashboards/create }
+:::
+::::
+:::::
+```
+
+The outer `{explore}` fence uses **five** colons so the four-colon `::::` card-group
+fences and three-colon `:::` link-card fences nest without closing it early. Add more
+colons on the outer fence if you need to nest deeper.
+
+## Options
+
+| Option | Notes |
+|---|---|
+| `:title:` | H2 heading for the section (for example, `Explore Kibana`). Required. |
+| `:intro:` | Optional intro paragraph below the heading. |
+| `:id:` | Section anchor. |
+
+## How nested directives change
+
+Inside `{explore}`, the same authoring you already use for card grids is reinterpreted:
+
+| Directive | Standalone rendering | Inside `{explore}` |
+|---|---|---|
+| `{card-group}` | Section heading + card grid | A collapsible accordion group (title in the header, cards inside) |
+| `{link-card}` | A bordered card | A titled link **column** (title and link list, with the `description` not shown in column mode) |
+| `{link-card}` `aside` | Inline "label: A · B · C" line | An **"Even more"** badge cluster under the column |
+
+Because the effect is driven by the `{explore}` ancestor, the card-group and link-card
+bodies don't need any extra options. Wrapping them is enough.
@@ -0,0 +1,67 @@
+# Get started section
+
+The first section of a hub-page body: a short onboarding funnel with an intro line and a set of numbered steps. A step can present two equally-weighted start **options** (for example, run locally versus try on Cloud), be a plain informational step, or link out as a whole card.
+
+## Basic
+
+```markdown
+:::{get-started}
+title: Get started in 3 steps
+intro: Spin up Elasticsearch and Kibana, connect your data, and start exploring in minutes.
+steps:
+  - title: Run Elasticsearch and Kibana
+    options:
+      - label: Run locally
+        description: Spin up Elasticsearch and Kibana on your machine for development.
+        code: curl -fsSL https://elastic.co/start-local | sh
+        language: sh
+        url: /deploy-manage/deploy/self-managed/install-kibana
+        url-label: Install self-managed
+      - label: Try on Cloud
+        description: Start a free Elastic Cloud trial. No local setup needed.
+        url: https://cloud.elastic.co/registration
+        url-label: Start a free trial
+  - title: Connect your data
+    description: Point Kibana at your data and create a data view.
+    link: /manage-data/ingest
+    link-label: Ingest data
+  - title: Explore and visualize
+    description: Open Discover, then build your first chart and dashboard.
+    link: /explore-analyze/kibana-data-exploration-learning-tutorial
+    link-label: Start the tutorial
+:::
+```
+
+## Fields
+
+| Field | Required | Description |
+|---|---|---|
+| `title` | yes | Section heading, for example `Get started in 3 steps`. |
+| `intro` | no | One-line lead sentence. Rendered as inline markdown. |
+| `steps[].title` | yes | Step heading, shown next to the step number. |
+| `steps[].description` | no | Short supporting sentence. Rendered as inline markdown. |
+| `steps[].link` | no | When set, the whole step is a clickable card linking here. |
+| `steps[].link-label` | no | Call-to-action label for a link step. Defaults to `Open`. |
+| `steps[].options[]` | no | Two or more equally-weighted start options, rendered side by side. |
+| `steps[].options[].label` | no | Option heading, for example `Run locally`. |
+| `steps[].options[].description` | no | Short supporting sentence. Rendered as inline markdown. |
+| `steps[].options[].code` | no | A command shown in a copyable snippet (the "run locally" path). |
+| `steps[].options[].language` | no | Syntax-highlighting language for the snippet (for example `sh`). |
+| `steps[].options[].url` | no | Destination for the option. Rendered as a text link when the option also has `code`, or as a button otherwise. |
+| `steps[].options[].url-label` | no | Label for the option link/button. |
+
+An earlier top-level `install` / `tutorial` pair is still accepted for backward compatibility, but new pages should express the two start paths as `options` on the first step instead.
+
+## Linking the hero to this section
+
+The rendered section carries `id="get-started"`, so a [`{hero}`](hero.md) action can scroll to it instead of adding a competing entry point:
+
+```markdown
+:primary-action: [Get started](#get-started)
+```
+
+## When to use
+
+`{get-started}` is the standard "front door" section between the [`{hero}`](hero.md) and the rest of the hub body. It's optional. Skip it when the hero already says what readers need to know next.
+
+It is **not** an admonition. For caution / note / tip-style callouts inside body content, use the existing [admonitions](admonitions.md).