v0.11.3 v0.17.10 v0.17.9 v0.17.8 v0.17.7 v0.17.6 v0.17.5 v0.17.4 v0.17.3 v0.17.2 v0.17.1 v0.17.0 v0.16.0 v0.15.1 v0.15.0 v0.14.0 v0.13.0 v0.12.2 v0.12.1 v0.12.0 master


Automatic persisted queries
You are looking at the docs for an older version (v0.11.3). The latest version is v0.17.10.

When you work with GraphQL by default your queries are transferred with every request. That can waste significant bandwidth. To avoid that you can use Automatic Persisted Queries (APQ).

With APQ you send only query hash to the server. If hash is not found on a server then client makes a second request to register query hash with original query on a server.


In order to enable Automatic Persisted Queries you need to change your client. For more information see Automatic Persisted Queries Link documentation.

For the server you need to implement PersistedQueryCache interface and pass instance to handler.EnablePersistedQueryCache option.

See example using go-redis package below:

import (


type Cache struct {
	client redis.UniversalClient
	ttl    time.Duration

const apqPrefix = "apq:"

func NewCache(redisAddress string, password string, ttl time.Duration) (*Cache, error) {
	client := redis.NewClient(&redis.Options{
		Addr:     redisAddress,

	err := client.Ping().Err()
	if err != nil {
		return nil, errors.WithStack(err)

	return &Cache{client: client, ttl: ttl}, nil

func (c *Cache) Add(ctx context.Context, hash string, query string) {
	c.client.Set(apqPrefix + hash, query, c.ttl)

func (c *Cache) Get(ctx context.Context, hash string) (string, bool) {
	s, err := c.client.Get(apqPrefix + hash).Result()
	if err != nil {
		return "", false
	return s, true

func main() {
	cache, err := NewCache(cfg.RedisAddress, 24*time.Hour)
	if err != nil {
		log.Fatalf("cannot create APQ redis cache: %v", err)
	c := Config{ Resolvers: &resolvers{} }
	gqlHandler := handler.GraphQL(
	http.Handle("/query", gqlHandler)