shithub: hugo

ref: 0c3d2b67e0af38a4c3935fb04f722a73ec1d3f8b
dir: /docs/content/en/variables/pages.md/

View raw version
---
title: Pages Methods
linktitle:
description: Pages is the core page collection in Hugo and has many useful methods.
date: 2019-10-20
categories: [variables and params]
keywords: [pages]
draft: false
menu:
  docs:
    title: "methods defined on a page collection"
    parent: "variables"
    weight: 21
weight: 21
sections_weight: 20
aliases: [/pages]
toc: true
---

Also see [List templates](/templates/lists) for an overview of sort methods.

## .Next PAGE

`.Next` and `.Prev` on `Pages` work similar to the methods with the same names on `.Page`, but are more flexible (and slightly slower) as they can be used on any page collection.

`.Next` points **up** to the next page relative to the page sent in as the argument. Example: `{{with .Site.RegularPages.Next . }}{{.RelPermalink}}{{end}}`. Calling `.Next` with the first page in the collection returns `nil`. 

## .Prev PAGE

`.Prev` points **down** to the previous page relative to the page sent in as the argument. Example: `{{with .Site.RegularPages.Prev . }}{{.RelPermalink}}{{end}}`. Calling `.Prev` with the last page in the collection returns `nil`.