hugo/docs/content/en/functions/collections/First.md

---
title: collections.First
description: Returns the given collection, limited to the first N elements.
categories: []
keywords: []
action:
  aliases: [first]
  related:
    - functions/collections/After
    - functions/collections/Last
  returnType: any
  signatures: [collections.First N COLLECTION]
aliases: [/functions/first]
---

```go-html-template
{{ range first 5 .Pages }}
  {{ .Render "summary" }}
{{ end }}
```

Set `N` to zero to return an empty collection.

```go-html-template
{{ $emptyPageCollection := first 0 .Pages}}
```

Use `first` and [`where`] together.

```go-html-template
{{ range where .Pages "Section" "articles" | first 5 }}
  {{ .Render "summary" }}
{{ end }}
```

[`where`]: /functions/collections/where