Page collections
Look up the methods and functions that return, filter, sort, and group page collections.
A page collection is a slice of Page objects.
Methods on Page and Site objects return page collections, and other methods and functions filter, sort, and group them.
Page
Use these Page methods when rendering lists on section pages, taxonomy pages, term pages, and the home page.
PAGE.Pages- Returns a collection of regular pages within the current section, and section pages of immediate descendant sections.
PAGE.RegularPages- Returns a collection of regular pages within the current section.
PAGE.RegularPagesRecursive- Returns a collection of regular pages within the current section, and regular pages within all descendant sections.
PAGE.Sections- Returns a collection of section pages, one for each immediate descendant section of the given page.
Site
Use these Site methods when rendering lists on any page.
SITE.AllPages- Returns a collection of all pages in all languages.
SITE.Pages- Returns a collection of all pages.
SITE.RegularPages- Returns a collection of all regular pages.
SITE.Sections- Returns a collection of top-level section pages.
Filter
Use the where function to filter page collections.
Sort
The default sort order for page collections, used when no other criteria are set, follows this priority:
weight(ascending)date(descending)linkTitlefalling back totitle(ascending)- Path relative to the
contentdirectory, including the file extension and any language identifier, converted to lower case with spaces replaced by hyphens (ascending)
Use these methods to sort page collections by different criteria.
PAGES.ByDate- Returns the given page collection sorted by date in ascending order.
PAGES.ByExpiryDate- Returns the given page collection sorted by expiration date in ascending order.
PAGES.ByLanguage- Returns the given page collection sorted by language.
PAGES.ByLastmod- Returns the given page collection sorted by last modification date in ascending order.
PAGES.ByLength- Returns the given page collection sorted by content length in ascending order.
PAGES.ByLinkTitle- Returns the given page collection sorted by link title in ascending order, falling back to title if link title is not defined.
PAGES.ByParam- Returns the given page collection sorted by the given parameter in ascending order.
PAGES.ByPublishDate- Returns the given page collection sorted by publish date in ascending order.
PAGES.ByTitle- Returns the given page collection sorted by title in ascending order.
PAGES.ByWeight- Returns the given page collection sorted by weight in ascending order.
PAGES.Reverse- Returns the given page collection in reverse order.
Group
Use these methods to group page collections.
PAGES.GroupBy- Returns the given page collection grouped by the given field in ascending order.
PAGES.GroupByDate- Returns the given page collection grouped by date in descending order.
PAGES.GroupByExpiryDate- Returns the given page collection grouped by expiration date in descending order.
PAGES.GroupByLastmod- Returns the given page collection grouped by last modification date in descending order.
PAGES.GroupByParam- Returns the given page collection grouped by the given parameter in ascending order.
PAGES.GroupByParamDate- Returns the given page collection grouped by the given date parameter in descending order.
PAGES.GroupByPublishDate- Returns the given page collection grouped by publish date in descending order.
Last updated:
November 8, 2026
:
content: Update description of quick reference guides (0e69942a8)
Improve this page