# Cypher query language

[Wiki](../README.md)

**On this page**

- [Statements and examples](#statements-and-examples)
- [Query workflow](#query-workflow)
- [Articles](#articles)

GDB implements a read/write subset of Cypher, plus documented extensions such as
element indexes and shared uniqueness. Begin with the [data model](data-model.md)
and [quickstart](../getting-started/quickstart.md).

## Statements and examples

The engine parses **one statement per call**, with an optional trailing semicolon.
Explorer splits a script and sends each statement as its own auto-commit operation;
it stops on the first error and keeps earlier commits. Use [transactions](../operations/transactions.md) when several
operations must commit atomically.

Cypher line comments begin with `//`. Parameters such as `$email` are supplied
by a driver or embedding API; they are values, not syntax substitutions.
Examples using labels assume the corresponding data exists, unless setup is
included. Constraint examples explicitly labelled as errors are intentional.

Keywords accepted as contextual identifiers depend on their parser position;
backtick-quote ambiguous labels, keys or variables. Follow the examples rather
than assuming every keyword is usable as an unquoted identifier.

## Query workflow

Read with [MATCH/WHERE](reading.md), update with [CREATE/MERGE/SET](writing.md),
then shape [results](results.md) using [functions](functions.md),
[aggregates](aggregates.md) and [expressions](expressions.md).
Use [subqueries and parameters](subqueries.md) to compose queries,
[paths](paths.md) for traversal, and [EXPLAIN](planning.md) to inspect index use.
See [compatibility](../reference/compatibility.md#query-language) for unsupported syntax.

## Articles

- [Aggregate functions](aggregates.md)
- [Data model and values](data-model.md)
- [Operators and expressions](expressions.md)
- [Scalar functions](functions.md)
- [Paths and shortest-path queries](paths.md)
- [EXPLAIN and PROFILE](planning.md)
- [Schema and maintenance procedures](procedures.md)
- [Matching and filtering graphs](reading.md)
- [Results, aggregation and row pipelines](results.md)
- [Procedures, subqueries and parameters](subqueries.md)
- [Creating and updating graphs](writing.md)

## Related articles

[Indexes and constraints](../indexes/README.md) · [Procedure directory](../reference/procedures.md) · [Transactions and concurrency](../operations/transactions.md)
