elastic / elastic/docs-content

Document why Discover and Dashboards show the "no data" screen, and how to get past it

Open
#7,877 3 comments 0 reactions 1 assignee Claimed by @florent-leborgne View on GitHub
good-for-ai needs-review Team:SKI weeks: 1
Dominant language
No language data
Stars
47
Forks
261
Avg merge
3d 21h
Merged PRs (30d)
141

Description

## Summary

Neither Discover nor Dashboards currently documents the conditions that trigger their "no data" welcome screen, or the ways to satisfy them. This came up while working #7633: [PR #279421](https://github.com/elastic/kibana/pull/279421) added a new way to bypass the screen (an ES|QL Data Federation dataset), but that's one of several existing paths that aren't documented anywhere either.

**Why this needs docs:** A user who lands on the no-data screen unexpectedly (for example, they have data but no data view) has no documented reference for what the screen actually checks or how to get past it.

## Known ways to get past the no-data screen (needs verification against source at draft time)

**Discover:**
- A data view exists that resolves to at least one index
- At least one non-hidden local Elasticsearch index or data stream exists (independent of a data view)
- {applies_to}`stack: experimental 9.6` At least one ES|QL Data Federation dataset exists

**Dashboards:**
- A data view exists that resolves to at least one index
- {applies_to}`stack: experimental 9.6` At least one ES|QL Data Federation dataset exists
- There are unsaved edits on the current dashboard
- At least one dashboard is already saved

This list needs re-verification at HEAD when drafted — I traced it from the [Kibana PR #279421 diff](https://github.com/elastic/kibana/pull/279421/files) but didn't audit the full decision tree end to end, and other apps with their own no-data screens (Visualize, Maps) are out of scope unless someone wants to expand it.

## Suggested next steps

- Search for the canonical home before drafting — no existing page covers this today (checked `/docs/troubleshoot/kibana` and the Discover/Dashboards getting-started pages).
- Likely candidates: a troubleshooting-shaped section on Discover's or Dashboards' own pages, or a new small reference page linked from both.

---
🤖 _Refined by RefineBot on 2026-08-10. Original intent preserved._

RefineBot changes

**What changed:**
- Marked the linked Kibana product issue as closed in the Resources section.
- Kept the issue scope, examples, and draft verification notes intact.

**What was preserved:**
- The request to document the no-data welcome screen for Discover and Dashboards.
- The list of known bypass paths and the suggested doc directions.

**Source:** Verified the linked Kibana issue status in `elastic/kibana`.

Previous version

## Summary

Neither Discover nor Dashboards currently documents the conditions that trigger their "no data" welcome screen, or the ways to satisfy them. This came up while working #7633: [PR #279421](https://github.com/elastic/kibana/pull/279421) added a new way to bypass the screen (an ES|QL Data Federation dataset), but that's one of several existing paths that aren't documented anywhere either.

**Why this needs docs:** A user who lands on the no-data screen unexpectedly (for example, they have data but no data view) has no documented reference for what the screen actually checks or how to get past it.

## Known ways to get past the no-data screen (needs verification against source at draft time)

**Discover:**
- A data view exists that resolves to at least one index
- At least one non-hidden local Elasticsearch index or data stream exists (independent of a data view)
- {applies_to}`stack: experimental 9.6` At least one ES|QL Data Federation dataset exists

**Dashboards:**
- A data view exists that resolves to at least one index
- {applies_to}`stack: experimental 9.6` At least one ES|QL Data Federation dataset exists
- There are unsaved edits on the current dashboard
- At least one dashboard is already saved

This list needs re-verification at HEAD when drafted — I traced it from the [Kibana PR #279421 diff](https://github.com/elastic/kibana/pull/279421/files) but didn't audit the full decision tree end to end, and other apps with their own no-data screens (Visualize, Maps) are out of scope unless someone wants to expand it.

## Suggested next steps

- Search for the canonical home before drafting — no existing page covers this today (checked `/docs/troubleshoot/kibana` and the Discover/Dashboards getting-started pages).
- Likely candidates: a troubleshooting-shaped section on Discover's or Dashboards' own pages, or a new small reference page linked from both.

---
*Created with [Docs Quest Scanner](https://github.com/florent-leborgne/docs-quest-scanner) by `@florent-leborgne`*

## Suggested edits

[Use ES|QL in the Kibana UI](https://www.elastic.co/docs/explore-analyze/query-filter/languages/esql-kibana) > Query structure
- **What the docs say:** FROM allows you to define the data sources to query by specifying data streams, ES|QL views, indices, or aliases.
- **What to add:** The list of data sources you can target with FROM does not mention federated (external) data sources, and nothing states that Discover and Dashboards can now be used with ES|QL when a deployment contains only federated data sources and no local or remote indices (previously the no-data screen blocked access). If the ES|QL data federation feature is being documented for this release, extend the FROM source list and add a short note about federated-only deployments; coordinate with the data federation reference page (esql-data-federation-sources) for a cross-link in both directions. Applies from 9.6.0 and in serverless.

TriageBot — Needs refinement

### 2026-08-10

**Type:** documentation

**Section check:**
- [✅] Summary: specific documentation gap is stated.
- [✅] Why this needs docs / suggested next steps: present and actionable.
- [✅] Known ways to get past the no-data screen: present, but still needs source verification before drafting.

**Ambiguity / scope notes:**
- None blocking.

**Cross-references:**
- [✅] `#7633` is open.
- [❌] `https://github.com/elastic/kibana/issues/279194` is closed.

**Next step:** Rewritten above.

> Generated by [Gh Aw Issue Triage](https://github.com/elastic/docs-content/actions/runs/31383414024) for #7877 · gpt50mini · 9.29 AIC · ⌖ 1.36 AIC · ⊞ 29K · [◷](https://github.com/search?q=repo%3Aelastic%2Fdocs-content+is%3Aissue+%22gh-aw-workflow-call-id%3A+elastic%2Fdocs-content%2Fgh-aw-issue-triage%22&type=issues)

Contributor guide

No contributing guide indexed for this repository

Assessment

This issue has not been assessed yet.

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.