Paginator

PAGE.Paginator

page.Pager

Pagination is the process of splitting a list page into two or more pagers, where each pager contains a subset of the page collection and navigation links to other pagers. The number of elements on each pager is determined by the value of the paginate setting in your site configuration. The default value is 10.

You can invoke pagination on the home page template, section templates, taxonomy templates, and term templates. Each of these receive a collection of regular pages in context. When you invoke the Paginator method, it paginates the page collection received in context.

{{ range .Paginator.Pages }}
  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
{{ end }}
{{ template "_internal/pagination.html" . }}

In the example above, the internal “pagination” template creates the navigation links between pagers.