# Pagination

Shopify uses cursor-based pagination, and this is a concept you will frequently use in your Mechanic tasks. Shopify has excellent coverage on the topics, I highly recommend reviewing their [documentation](https://shopify.dev/concepts/graphql/pagination).

In the query below you'll notice the fields`pageInfo` and `cursor`. These are important concepts for pagination, make sure to review them in the resources listed below. Page info tells us if there is another page of results before or after the current page. The `cursor` field provides a reference to an edge's position, which is then used as an anchor to retrieves nodes before or after it in the connection.

```graphql
query {
  orders(first: 10) {
    pageInfo { # Returns details about the current page of results
      hasNextPage # Whether there are more results after this page
      endCursor # A marker for the last result in this page
    }
    nodes {
      name # The fields to be returned for each node
    }
  }
}
```

## Great resources for learning GraphQL pagination

### Key concepts to read up on

* [ ] Connections
* [ ] Edges
* [ ] Nodes
* [ ] pageInfo
* [ ] hastNextPage
* [ ] endCursor
* [ ] Cursor-based pagination

{% hint style="success" %}
<https://shopify.dev/concepts/graphql/pagination>
{% endhint %}

{% hint style="success" %}
<https://graphql.org/learn/pagination/>
{% endhint %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://learn.mechanic.dev/platform/graphql/basics/pagination.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.