Skip to content Skip to footer navigation
Light theme Dark theme

Collection-previous Tag

If you're on a single entry page and want to show previous entries in order (publish date, alphabetical, or manual), this is the tag you're looking for.

Date Order

This tag relies on the native publish date field for date ordering.

Example

This will show the next 2 posts in a blog collection. It'll scope the entries loop into the posts tag pair. If there are no more entries, the no results text will be shown.

{{ collection:previous in="blog" as="posts" limit="2" sort="date:asc" }}
 
  {{ if no_results }}
    No more posts to read!
  {{ /if }}
 
  {{ posts }}
    <div class="post">
      <a href="{{ url }}">{{ title }}</a>
    </div>
  {{ /posts }}
 
{{ /collection:previous }}
<statamic:collection:previous
  in="blog"
  as="posts"
  limit="2"
  sort="date:asc"
>
  @if ($no_results)
    No more posts to read!
  @endif
 
  @foreach ($posts as $post)
    <div class="post">
      <a href="{{ $post->url }}">{{ $post->title }}</a>
    </div>
  @endforeach
</statamic:collection:previous>
Hot Tip!

This functions the same way as the collection:next tag but in the opposite direction.

A troll pointing a teaching stick

Parameters

in|collection

string

Explicitly define a collection. Defaults to whatever collection the current entry is in.

current

string

Explicitly define a current entry by id. Defaults to the current entry in context.

collection params

inheritance

All collection tag parameters are available.

Variables

Variable Type Description

no_results

 boolean

true if no results.