Frequently Asked Questions

Find answers to the most common questions about GraphQL and the Graphcool platform.

Combining multiple GraphQL queries or mutations in one request

In GraphQL you can run multiple queries or mutations in one request using GraphQL aliases.

How to Use the GraphQL Directives Skip and Include?

GraphQL directives encode additional functionalities. Using the skip and include directives you can control the shape of queries and mutations.

Using GraphQL Fragments

GraphQL fragments allow you to construct groups of fields that can be included in queries where you need them.

How to download the GraphQL SDL Schema

GraphQL servers expose a type safe GraphQL schema. You can download it in SDL syntax and use it with Relay Modern or other tools.

Tips And Tricks: The GraphQL Playground

The GraphQL Playground GraphiQL is a super handy tool. Use these simple tricks for a great developer experience when working with GraphQL.

Flexibility And Control With GraphQL Variables

GraphQL variables extend queries and mutations to be more flexible and can be used for simple scalar values, enums or input object types.

The Mutation Payload In GraphQL

Mutations can be used to execute different data changes. The mutation payload in GraphQL is the data that is returned as a result of the mutation.

Configuring Permissions For User Signup With GraphQL

The advanced permission system can be used to control user authentication for different types of applications.

Importing complex data using a script

Use a script to import nested JSON data to your GraphQL backend.

Importing simple data using a script

Use a script to import simple JSON data to your GraphQL backend.

Migrating Data using a Node Script

When you want to bulk migrate your existing data, you can run a migration script that combines multiple GraphQL mutations in one GraphQL request.

Deleting all nodes of a specific type

Using node and Lokka you can quickly delete all nodes of a specific type with a small script.

Creating Json data with GraphQL

Using node and graphql-request you can easily create JSON data with GraphQL. By using GraphQL variables and we do not need to escape the data.

Uploading Remote Files with Node

Using node and request you can upload remote files as form data.

Authenticating API Calls From Functions

Functions can hook into GraphQL events to implement custom business logic. Learn how authentication works with GraphQL in a serverless context.

Calling the API from a Function with Lokka

Send queries and mutations to the GraphQL client APIs from a Function using GraphQL Lokka.

Calling the API from a Function with plain HTTP

Send queries and mutations to the GraphQL client APIs from a Function using plain http requests.

Cursor-based Pagination with GraphQL

Cursor-based pagination is a common pattern in GraphQL to display content in equally sized pages that allow forward and backward navigation.


Keep track of the latest features and improvements to the Graphcool platform.

How to choose the correct relation?

Learn what relations are and how you can make the correct choice when designing relations as part of your GraphQL schema and data model.

What technology is Graphcool using?

Learn more about the technology and infrastructure used at Graphcool.

How do Insufficient Permissions affect the Query Response?

The GraphQL specification defines the interaction of optional or required fields in the query response with things like insufficient permissions.

How to query the currently logged-in user?

Learn how to send a GraphQL query to fetch signed in users that are registered with an authentication provider like Auth0 or Digits.

How to use GraphQL Introspection Queries?

GraphQL servers expose a type safe GraphQL schema. You can query information about the schema using GraphQL introspection queries.

How to Store Meta Information for Relations

Relations describe the interaction between two types. To store additional information for connected nodes, you can introduce a meta type.

GraphQL SDL - Schema Definition Language

GraphQL SDL is the syntax to specify a GraphQL schema through type definitions, enums, interfaces and other concepts.

How Does Aggregation Work In GraphQL?

Aggregation functions can be used to compile information across your dataset. Learn how aggregation works in GraphQL.

Managing Date and Time Values in GraphQL

Manage date and time values with the ISO 8601 format when working with your GraphQL server.

How to migrate my data after schema changes?

When working with fields in your GraphQL schema, you might have to migrate existing data. More complex scenarios can be handled by a script.

How to Export Your GraphQL Project

We're embracing open source and widely used technologies such as GraphQL and AWS Lambda and are dedicated to provide a good migration strategy.

Simple API Cheatsheet

All the capabilities of the Simple API collected in a compact cheatsheet.

Connecting to a GraphQL Server in Two Simple Steps

Connecting to a GraphQL server can be done in two simple steps with GraphQL clients like Apollo, Relay or Lokka.

Duplicating a Graphcool Project

Whether you want to quickly test a new feature or you need to configure a multi-stage environment, duplicating a Graphcool project comes in handy.

How to model Locations in GraphQL?

In many applications, working with locations is of particular interest. Learn about best practices for the location type in GraphQL.

How can I define relations in an SDL schema file?

A GraphQL Schema Definition is the easiest way to describe an entire GraphQL API. Using the relation tag, you can define GraphQL relations.