GraphQL reference

This section provides reference information for the FaunaDB GraphQL API.

You can find step-by-step GraphQL tutorials in the Tutorials section.


For more general information about GraphQL, training, or the specification itself, see these resources:

There are a few online, interactive GraphQL interfaces. The one we recommend is GraphQL Playground. It is embedded into FaunaDB Console.

For developers, the FaunaDB GraphQL API should work with most GraphQL libraries. See the next section for known limitations.


The FaunaDB GraphQL API is in its initial release. It is functional, and can handle most GraphQL workloads. However, there are some GraphQL features that are currently not supported:

  • Only works with FaunaDB (no on-premise installation available, for now).

  • Schemas do not support:

    • Custom directives

    • Custom interfaces

    • Custom scalars

    • Union types

  • No name can start with an underscore (_)

  • Subscriptions are not supported.

Also, FaunaDB GraphQL API can only work with the defined schema. Any existing collections, indexes, or functions that may exist in a database, that are not referenced in the GraphQL schema, are unavailable to GraphQL queries.

Was this article helpful?

We're sorry to hear that.
Tell us how we can improve!

Thank you for your feedback!