Skip to main content
Version: 4.0

2.9.1 Views

A View is a Projection whose Cypher query returns nodes and relationships from the knowledge graph.

Use a View when you want graph-shaped results. For a count, an aggregation or any other shape, write a Function instead.

Create a View​

Choose Add New, then Add view, and fill in:

  • Title: a name for the View.
  • Description (optional): a short description.
  • View slug: the unique identifier used to run the View. It may contain only lower-case letters, digits and hyphens, and may not start or end with a hyphen.
  • Definition: the Cypher query. It must return nodes and relationships (for example MATCH (c:docs_customers)-[r:PLACED]->(o:docs_orders) WHERE c.city IN $city RETURN c, r, o).
  • Query timeout (seconds) (optional): see Query timeout.

Reference any parameters in the query with a $ prefix; they appear under Parameters for you to give values. You can also let Ask AI write the query. Choose Save.

The View editor for docs_customer_orders: the slug, the published version with its query timeout and $city parameter, and the Cypher definition with Ask AI, Format and Execute v1.0 above it

Execute a View​

Set values for any parameters, then choose Execute view (or Execute draft or Execute v1.0, depending on the selected version). The result shows how many nodes and relationships the query returned:

  • Graph View draws the result. Click a node to see its properties. For readability, the graph shows at most 20 nodes; the full result is always in the JSON View.
  • JSON View shows the complete raw result.

Use Re-run to run the query again, and Collapse results to make room for the editor. If the run fails, Fix with AI helps you correct the query.

The View's result for the cities Graz and Salzburg: 42 nodes, of which the graph shows 20, with the properties of the selected docs_customers node on the right

Manage a View​

From the View's ⋮ menu:

  • Duplicate view: create a copy as a new draft.
  • Delete view: remove the View. Deleting its last version removes the View entirely.

Use the Version section to Publish version (make a draft live) and to manage the version history. See Versions for how draft and published versions work.