Matching Patterns with Cypher MATCH
Master the MATCH clause to find specific patterns of nodes and relationships within your graph data.
Matching Patterns with Cypher MATCH is a free Neo4j Graph Database Fundamentals lesson on CoddyKit — lesson 3 of 4. You can read the complete lesson below for free — then practise it hands-on in the browser with a built-in code editor and a 24/7 AI tutor. It is part of the Neo4j Graph Database Fundamentals learning path, one of 4 lessons in the course, and your progress syncs across the web and the CoddyKit app.
Discovering Data with MATCH
Welcome to the core of graph querying! The MATCH clause in Cypher is how you find specific patterns of data in your Neo4j graph.
Think of it like drawing the shape of the data you want to find. You describe nodes, relationships, and their properties, and Neo4j finds all instances that fit your description.
Finding Any Node
The simplest MATCH query finds any node in your graph. You represent a node using parentheses ().
Adding a variable inside, like (n), lets you refer to that node later, for example, to return its properties. We'll use LIMIT to show just a few results.
MATCH (n)
RETURN n LIMIT 3Matching Nodes by Label
Graphs often have different types of nodes. In Cypher, these types are called labels. You can specify a label to find only nodes of a particular type.
Labels are placed after the node variable, separated by a colon: (variable:Label).
MATCH (p:Person)
RETURN p.name LIMIT 3Matching Nodes by Property
Nodes also have properties, which are key-value pairs describing them. You can filter nodes based on these properties directly within your MATCH clause.
Properties are placed inside curly braces {} after the label (or variable if no label): (node:Label {key: 'value'}).
MATCH (m:Movie {title: 'The Matrix'})
RETURN m.releaseYearIntroducing Relationships
Relationships define how nodes are connected. In MATCH, you represent a relationship using dashes and angle brackets: -- for undirected, --> for directed, and <-- for reverse directed.
You can also assign a variable to the relationship, like -[r]-, to work with it.
MATCH (a)-[r]->(b)
RETURN a.name, TYPE(r), b.title LIMIT 3Matching Relationships by Type
Just like nodes have labels, relationships have types. Specifying a relationship type helps you find specific kinds of connections between nodes.
The type is placed after the relationship variable, separated by a colon: -[r:TYPE]->.
MATCH (p:Person)-[:ACTED_IN]->(m:Movie)
RETURN p.name, m.title LIMIT 3Matching with Direction
Relationships are directional! The arrows in your MATCH pattern indicate the flow. If you omit arrows (e.g., (a)-[r]-(b)), the match will be undirected, finding connections regardless of their stored direction.
It's generally best practice to specify direction when you know it.
MATCH (director:Person)<-[:DIRECTED]-(movie:Movie)
RETURN director.name, movie.title LIMIT 3Combining Node & Relationship Patterns
The real power of MATCH comes from combining nodes and relationships to describe complex patterns in your graph. You can chain multiple nodes and relationships together.
This allows you to find paths, connections through intermediate nodes, and more.
MATCH (p:Person {name: 'Tom Hanks'})-[:ACTED_IN]->(m:Movie)<-[:DIRECTED]-(d:Person)
RETURN p.name, m.title, d.nameFinding Optional Connections
Sometimes, a part of your pattern might not always exist. OPTIONAL MATCH tries to find the pattern, but if it doesn't, the unmatched parts will be null instead of failing the whole query.
This is useful when you want to see existing connections while still returning the main node even if a specific connection is missing.
MATCH (p:Person {name: 'Keanu Reeves'})
OPTIONAL MATCH (p)-[r]->(m:Movie)
RETURN p.name, TYPE(r), m.titleMatch Clause Challenge
Which Cypher MATCH clause correctly finds all movies directed by 'Quentin Tarantino'?
Recap: Mastering MATCH
Great job! You've learned the fundamental skill of finding patterns in your graph using the MATCH clause.
- Use
()for nodes,--for relationships. - Specify labels (
:Label) for node types and types (:TYPE) for relationships. - Filter by properties using
{}. - Arrows (
-->,<--) define relationship direction. OPTIONAL MATCHhelps find patterns that might not always exist without breaking the query.
Next, we'll explore how to refine your matched data using WHERE and ORDER BY!
Frequently asked questions
Is the “Matching Patterns with Cypher MATCH” lesson free?
Yes — the full text of “Matching Patterns with Cypher MATCH” is free to read here on the web, and the Neo4j Graph Database Fundamentals course includes 4 lessons in total. To practise it interactively (a built-in code editor and a 24/7 AI tutor) and unlock the rest of the Neo4j Graph Database Fundamentals course, upgrade to CoddyKit PRO.
What will I learn in “Matching Patterns with Cypher MATCH”?
Master the MATCH clause to find specific patterns of nodes and relationships within your graph data. You practise Neo4j Graph Database Fundamentals with hands-on code you run directly in the browser, and a 24/7 AI tutor answers your questions as you work through the lesson.
Do I need any experience to start Neo4j Graph Database Fundamentals?
No prior experience is required. Neo4j Graph Database Fundamentals on CoddyKit is structured for beginners through advanced learners; this is — lesson 3 of 4, so you can start here or from the beginning and move at your own pace.
How long does the “Matching Patterns with Cypher MATCH” lesson take?
Most CoddyKit lessons take about 5–10 minutes. Each one is bite-sized and interactive, so you make steady progress and pick up exactly where you left off across the web and the app.
Can I write and run code in this Neo4j Graph Database Fundamentals lesson?
Yes. Every Neo4j Graph Database Fundamentals lesson includes a built-in code editor, so you write and run real code right in your browser and get instant AI feedback — no local setup required.
All lessons in this course
- Nodes, Relationships, and Properties
- Creating Data with Cypher CREATE
- Matching Patterns with Cypher MATCH
- Returning and Shaping Results with RETURN