Neo4j Docs Docs
Docs
Neo4j DBMS
  • Getting Started
  • Operations
  • Migration and Upgrade
  • Status Codes
  • Java Reference
  • Kerberos Add-on
Neo4j Aura
  • Neo4j Aura
  • Neo4j AuraDB
  • Neo4j AuraDS
Neo4j Tools
  • Neo4j Bloom
  • Neo4j Browser
  • Neo4j Data Importer
  • Neo4j Desktop
  • Neo4j Ops Manager
  • Neodash commercial
Neo4j Graph Data Science
  • Neo4j Graph Data Science Library
  • Neo4j Graph Data Science Client
Cypher Query Language
  • Cypher
  • Cypher Cheat Sheet
  • APOC Library
Generative AI
  • Neo4j GraphRAG for Python
  • Embeddings and vector indexes tutorial
  • GenAI integrations
  • Vector search indexes
  • Vector search functions
  • GraphQL vector index search documentation
Create applications
  • Python Driver
  • Go Driver
  • Java Driver
  • JavaScript Driver
  • .Net Driver
  • Neo4j GraphQL Library
  • Neo4j Visualization Library
  • OGM Library
  • Spring Data Neo4j
  • HTTP API
  • Neo4j Query API
  • Bolt
Connect data sources
  • Neo4j Connector for Apache Spark
  • Neo4j Connector for Apache Kafka
  • Change Data Capture (CDC)
  • BigQuery to Neo4j
  • Google Cloud to Neo4j
Labs
GenAI Ecosystem
  • LLM Knowledge Graph Builder
  • Vector Index & Search
  • LangChain
  • LangChain.js
  • LlamaIndex
  • Haystack
  • DSPy
Developer Tools
  • APOC Extended
  • Aura CLI
  • arrows.app
  • Cypher Workbench
  • ETL Tool
  • NeoDash
Frameworks & Integrations
  • Needle Starter Kit
  • Neo4j Plugin for Liquibase
  • Neo4j Migrations
  • neomodel
RDF & Linked Data
  • Neosemantics (Java)
  • RDFLib-Neo4j (Python)
Get Help
Community Forum
Discord Chat
Knowledge Base
Neo4j Developer Blog
Neo4j Videos
GraphAcademy
Beginners Courses
  • Neo4j Fundamentals
  • Cypher Fundamentals
  • Importing Data Fundamentals
  • Importing CSV Data
  • Graph Data Modeling
Data Scientist Courses
  • Into to Graph Data Science
  • Graph Data Science Fundamentals
  • Path Finding
Generative AI Courses
  • Neo4j & LLM Fundamentals
  • Vector Indexes & Unstructured Data
  • Build a Chatbot with Python
  • Build a Chatbot with TypeScript
Neo4j Certification
  • Neo4j Certified Professional
  • Neo4j Graph Data Science Certification
Get Started Free
Search
Skip to content
Cypher Manual
Product Version
    • Introduction
      • Overview
      • Cypher and Neo4j
      • Cypher and Aura
    • Queries
      • Core concepts
      • Basic queries
      • Composed queries
        • Combined queries (UNION)
        • Conditional queries (WHEN)
    • Clauses
      • Clause composition
      • CALL procedure
      • CREATE
      • DELETE
      • FILTER
      • FINISH
      • FOREACH
      • LIMIT
      • LOAD CSV
      • MATCH
      • MERGE
      • OPTIONAL MATCH
      • ORDER BY
      • REMOVE
      • RETURN
      • SET
      • SHOW FUNCTIONS
      • SHOW PROCEDURES
      • SHOW SETTINGS
      • SHOW TRANSACTIONS
      • SKIP
      • TERMINATE TRANSACTIONS
      • UNWIND
      • USE
      • WHERE
      • WITH
    • Subqueries
      • CALL subqueries
      • CALL subqueries in transactions
      • COLLECT subqueries
      • COUNT subqueries
      • EXISTS subqueries
    • Patterns
      • Primer
      • Fixed-length patterns
      • Variable-length patterns
      • Shortest paths
      • Non-linear patterns
      • Syntax and semantics
    • Values and types
      • Property, structural, and constructed values
      • Temporal values
      • Spatial values
      • Working with null
      • Lists
      • Maps
      • Casting data values
      • Equality, ordering, and comparison of value types
    • Expressions
      • Expressions overview
      • Predicates
        • Boolean operators
        • Comparison operators
        • List operators
        • String operators
        • Path pattern expressions
        • Type predicate expressions
      • Conditional expressions (CASE)
    • Functions
      • Aggregating functions
      • Database functions
      • Graph functions
      • List functions
      • LOAD CSV functions
      • Mathematical functions - logarithmic
      • Mathematical functions - numeric
      • Mathematical functions - trigonometric
      • Predicate functions
      • Scalar functions
      • Spatial functions
      • String functions
      • Temporal functions - duration
      • Temporal functions - instant types
      • User-defined functions
      • Vector functions
    • GenAI integrations
    • Indexes
      • Search-performance indexes
        • Create, show, and delete indexes
        • The impact of indexes on query performance
        • Index hints for the Cypher planner
      • Semantic indexes
        • Full-text indexes
        • Vector indexes
      • Syntax
    • Constraints
      • Create, show, and drop constraints
      • Syntax
    • Execution plans and query tuning
      • Understanding execution plans
      • Operators
        • Operators in detail
      • Cypher runtimes
        • Concepts
        • Parallel runtime: reference
      • Query tuning
    • Query caches
      • Unifying query caches
    • Administration
    • Syntax
      • Parsing
      • Naming rules and recommendations
      • Variables
      • Keywords
      • Parameters
      • Operators
      • Comments
    • Deprecations, additions, and compatibility
    • Appendix
      • Cypher styleguide
      • GQL conformance
        • Supported mandatory GQL features
        • Currently unsupported mandatory GQL features
        • Supported optional GQL features
        • Optional GQL features and analogous Cypher
        • Additional Cypher features
      • Tutorials and extended examples
        • Basic query tuning example
        • Advanced query tuning example
        • Shortest path planning

Is this page helpful?

  • Cypher Manual
  • Queries
Raise an issue

Queries

This section provides a brief overview of the core concepts of a Cypher® query (nodes, relationships, and paths), and examples of how to query a Neo4j graph database. It also discusses how to compose combined queries using UNION and conditional queries using WHEN.

  • Core concepts

  • Basic queries

  • Composed queries

    • Combined queries (UNION)

    • Conditional queries (WHEN) Introduced in Neo4j 2025.03

Cypher and Aura Core concepts

Learn

  • Sandbox
  • Neo4j Community Site
  • Neo4j Developer Blog
  • Neo4j Videos
  • GraphAcademy
  • Neo4j Labs

Social

  • Twitter
  • Meetups
  • Github
  • Stack Overflow
  • Want to Speak?

Contact Us →

  • US: 1-855-636-4532
  • Sweden +46 171 480 113
  • UK: +44 20 3868 3223
  • France: +33 (0) 1 88 46 13 20

© 2025 Neo4j, Inc.
Terms | Privacy | Sitemap

Neo4j®, Neo Technology®, Cypher®, Neo4j® Bloom™ and Neo4j® Aura™ are registered trademarks of Neo4j, Inc. All other marks are owned by their respective companies.