Build your first dashboard

In the previous lesson, you learned how to describe your data model and identify stakeholder requirements.

In this lesson, you will learn how to:

  • Create interactive dashboards using the dashboard tool

  • Build dashboard cards using natural language AI prompts

  • Add filters to make dashboards dynamic

Understanding the Dashboards tool

A dashboard tool transforms data into visual representations, allowing you to represent it in different ways suitable to your use case.

Dashboards serve as the "storefront window" for your graph data - they display the most important insights in a visual format.

The AI tool allows you to quickly prototype and build production-ready dashboards.

Creating your first movie recommendation dashboard

Build a dashboard that visualizes actor relationships in your movie recommendation dataset. This dashboard will help stakeholders understand which actors frequently collaborate and how these relationships influence movie recommendations.

Navigate to the Dashboards tool:

dashboard_connect

Before creating your dashboard, make sure your instance contains the sample movie data. If you haven’t done that yet, go back to lesson 3 - Exploring Dashboards in the Getting Started module and follow the steps to load the data.

Go to the Dashboards tool and click Create with AI to begin.

Enter a description of the insights you want to visualize. For example, you can enter a description like "Visualize actor relationships in movies." or simply "Actor relationships":

create_with_ai_prompt

Be specific

Be specific about the node labels and relationship types to ensure accurate results.

Create a new AI generated dashboard by clicking the "Generate with AI" button, which will prompt you to enter a description of the insights you want to visualize. The AI will then generate a dashboard based on your description:

You should have a dashboard that looks similar to this:

Adding more cards

Dashboard cards are individual components that display specific data visualizations.

Click Add a card to create your next visualization:

dashboard_editor

You can create cards using AI prompts or Cypher queries. To create a card with AI, use the natural language feature in the card editor:

Creating cards with Cypher queries

Create cards using Cypher queries directly for more precise control over what data is displayed.

From your dashboard, click Add a card to open the card editor.

Use the card editor to define the card properties:

  • Change the card title from "New card" to something descriptive like "Actor Overview"

  • Select Graph from the visualization type dropdown

  • Paste your Cypher query into the Query field

For example, create a card that shows which movies Tom Hanks has acted in:

cypher
MATCH (p:Person)-[r:ACTED_IN]->(m:Movie)
WHERE p.name = 'Tom Hanks'
RETURN p,r,m

Your dashboard will display a graph visualization showing 'Tom Hanks' movie connections:

Repositioning cards

Move cards by dragging them using the six-dot handle that appears when you hover over a card.

Editing cards

Production dashboards often require updates as data and requirements evolve.

You can edit a dashboard card by clicking the three-dot menu on the card and selecting Edit card.

Make the changes you want, then click Save changes to update the card.

Making dashboards interactive with filters

Filters allow users to dynamically change what data is displayed without modifying queries.

To add a filter to your dashboard, go to the dashboard view and select Add filter:

dashboard_filter

For example, create a "Person selection" filter that will control which actor’s data is displayed.

Now update your Actor Overview card query to use the filter parameter:

cypher
MATCH (p:Person)-[r:ACTED_IN]->(m:Movie)
WHERE p.name = $person_name
RETURN p,r,m

Save your changes and test the filter:

dashboard_selection

Your dashboard now responds dynamically to filter selections:

dashboard_result

Where dashboards fit in your workflow

The dashboard tool enables:

  • Quick data exploration and validation

  • Creating presentations

  • Building operational monitoring dashboards

  • Prototyping before investing in custom applications

Check your understanding

Using AI to create recommendation dashboards

You want to create a dashboard card that shows "movies by genre and their average ratings" for your movie recommendation system. What do you need to provide to the AI tool?

  • ❏ A complex Cypher query with multiple JOINs

  • ✓ A natural language description of what you want to visualize

  • ❏ Additional software installation

  • ❏ Multiple database instances

Hint

The AI tool generates visualizations based on natural language descriptions. You describe what insights you want to see (like "movies by genre and ratings"), and the AI creates the corresponding dashboard cards and Cypher queries automatically.

Solution

A natural language description of what you want to visualize.

To use the AI tool in Neo4j Dashboards, provide a natural language description of the insights you want to see. For example, "Show movies by genre and their average ratings" or "Visualize actor relationships in movies." The AI will generate the Cypher queries and create the visualization cards automatically. You don’t need to write queries yourself when using AI, though you can also write Cypher queries directly if you prefer more control.

Summary

In this lesson, you learned how to create interactive dashboards, build dashboard cards with natural language AI prompts, and add filters to make your dashboards dynamic and user-friendly.

In the next lesson, you will learn how to:

  • Organize dashboard structure and create dashboard pages

  • Customize card styling

  • Visualize aggregated metrics

Chatbot

How can I help you today?