1 files changed, 31 insertions, 0 deletions
diff --git a/docs/content/en/methods/pages/ByDate.md b/docs/content/en/methods/pages/ByDate.md
new file mode 100644
index 000000000..eb4e86535
--- /dev/null
+++ b/docs/content/en/methods/pages/ByDate.md
@@ -0,0 +1,31 @@
+---
+title: ByDate
+description: Returns the given page collection sorted by date in ascending order.
+categories: []
+keywords: []
+action:
+  related:
+    - methods/pages/ByExpiryDate
+    - methods/pages/ByLastMod
+    - methods/pages/ByPublishDate
+  returnType: page.Pages
+  signatures: [PAGES.ByDate]
+---
+
+When sorting by date, the value is determined by your [site configuration], defaulting to the `date` field in front matter.
+
+[site configuration]: /getting-started/configuration/#configure-dates
+
+```go-html-template
+{{ range .Pages.ByDate }}
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
+{{ end }}
+```
+
+To sort in descending order:
+
+```go-html-template
+{{ range .Pages.ByDate.Reverse }}
+  <h2><a href="{{ .RelPermalink }}">{{ .LinkTitle }}</a></h2>
+{{ end }}
+```