Import a dashboard

Serverless Elastic Cloud Serverless projects are autoscaled environments, fully managed by Elastic and available on Elastic Cloud. Availability Generally available This functionality is generally available and ready for production usage. Serverless interfaces and procedures might differ from classic Elastic Stack deployments. Stack Planned The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability Planned We plan to add this functionality in a future Elastic Stack update. Subject to changes. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes. Recreate a dashboard from its JSON file without writing an API request. Kibana checks the file as soon as you select it, so you can see what it removes and what the dashboard depends on before you import.

Prerequisites

• A dashboard JSON file of 1 MB or less, from Export JSON or from the Dashboards API.
• All privilege for the Dashboard feature in Kibana. Without it, Import dashboard doesn't appear.

Import the file

1. Go to Dashboards.
2. From the application menu, select Import dashboard.
3. In the Import dashboard flyout, select your file under Select a JSON file. Kibana checks the file right away.
4. Review any messages in the flyout. If Kibana shows an error, fix the file or select a different one. If it shows a warning, review it before you continue.
5. Select Import.

Kibana creates a new dashboard in the current space, closes the flyout, shows a confirmation message, and refreshes the list of dashboards so the new dashboard appears. It never updates an existing dashboard, so importing the same file again creates another dashboard.

Messages after you select a file

Serverless Elastic Cloud Serverless projects are autoscaled environments, fully managed by Elastic and available on Elastic Cloud. Availability Generally available This functionality is generally available and ready for production usage. Serverless interfaces and procedures might differ from classic Elastic Stack deployments. Stack GA 9.5+ … The Elastic Stack includes Elastic's core products such as Elasticsearch, Kibana, Logstash, and Beats. Availability Generally available since 9.5 This functionality is generally available and ready for production usage. Preview in 9.4 This functionality is in technical preview and is ready for evaluation. Use with caution in production; it is not recommended for mission-critical workloads. Elastic will work to fix any issues, but features in technical preview are not subject to the support SLA of official GA features. Specific Support terms apply. Unless stated otherwise on the page, this functionality is available when your Elastic Stack is deployed on Elastic Cloud Hosted, Elastic Cloud Enterprise, Elastic Cloud on Kubernetes, and self-managed environments. This documentation corresponds to the latest patch available for each minor version. If you're not using the latest patch, check the release notes for changes. Recreate the dashboard by sending its JSON definition to the Dashboards API.

Prerequisites

• The dashboard's API-compatible JSON. Refer to Export and share Kibana dashboards to produce it.
• All privilege for the Dashboard feature in Kibana.
• A way to call the API, such as Kibana Dev Tools Console or an API key.

Send the JSON to the Dashboards API in the target instance, deployment, or project. The API creates the dashboard in the space identified by the request path, or updates it in place when you send it with an existing ID. The JSON export flow can open a pre-populated request in Kibana Dev Tools Console, where you set the space in the request path before sending it.

For the imported dashboard to work, the objects it references, such as data views and library visualizations, must also exist in the target environment. To version-control dashboards and keep their references portable across environments, refer to Manage dashboards as code.

Import the dashboard and its related objects from an NDJSON file on the Saved Objects page.

Prerequisites

• An NDJSON file containing the dashboard and its related objects. To produce one, refer to Export saved objects.
• All privilege for the Dashboard and Saved Objects Management features in Kibana.
• Access to Stack Management in Kibana.

Import the dashboard from the Saved Objects page under Stack Management. When you import a dashboard, you also import its related objects, such as data views and visualizations. Import options control how the import handles these related objects:

• Check for existing objects: When selected, objects are not imported when another object with the same ID already exists in this space or cluster. For example, if you import a dashboard that uses a data view which already exists, the data view is not imported and the dashboard uses the existing data view instead. You can also choose which of the imported or existing objects to keep by selecting Request action on conflict.
• Create new objects with random IDs: All related objects are imported and are assigned a new ID to avoid conflicts.

To automate the import, use the import saved objects API instead.