Pagination

Paginate query resultsAnchor

Hygraph supports various arguments for paginating content entries:

{
  posts(first: 6) {
    id
  }
}

{
  posts(last: 6) {
    id
  }
}

{
  posts(first: 6, skip: 6) {
    id
  }
}

{
  posts(last: 6, before: "...") {
    id
  }
}

{
  posts(first: 6, after: "...") {
    id
  }
}

Pagination limitsAnchor

To fetch the pagination limits of your projects, you need to access the API Playground section of your Hygraph project, select Management API from the Environment dropdown located at the top of the screen, and run the following query:

{
  viewer {
    project(id: "<PROJECTID>") {
      defaultPaginationSize
      maxPaginationSize
    }
  }
}

Nested paginationAnchor

You can also use first, last, skip, before, and after arguments with any nested relations. For example, let's imagine our post has comments:

{
  posts {
    id
    comments(first: 6, skip: 6) {
      id
      createdAt
    }
  }
}

Relay cursor connectionsAnchor

Hygraph follows the Relay cursor connection specification. Each of your project models also contain a connection type, automatically managed by Hygraph.

The example below shows us how we can query for the first 3 posts, after the cursor (ID) abc. We can also query pageInfo to check whether there are more pages using hasNextPage.

The PageInfo is useful when paginating.

{
  postsConnection(first: 3, after: "abc") {
    edges {
      cursor
      node {
        id
        title
      }
    }
    pageInfo {
      hasNextPage
      hasPreviousPage
      startCursor
      endCursor
      pageSize
    }
  }
}

Learn more about fetching with Relay.