---
draft: true

title: Pagination
related: ['sortBy', 'groups', 'class.List', 'lists']
description: >
  How to add pagination to your assemble project.
collection: docs
category: api
---

## Use cases

- paginate a list of blog posts
- paginate tags or categories


- paging
- sorting
- grouping
- permalinks


- collection view
- list view
- paginated list views
- grouped list views

## Collection groups

**Example**

Walkthrough...

1. Group a collection by whatever properties you want
2. Optionally paginate
2. Specify a `Index` view to be used for each page of grouped views
3. Generate the pages
