# Pagination broken, instructions make no sense

**URL:** <https://talk.jekyllrb.com/t/pagination-broken-instructions-make-no-sense/9344>\
**Category:** Uncategorized\
**Created:** [July 25, 2024, 12:21am UTC](https://talk.jekyllrb.com/t/pagination-broken-instructions-make-no-sense/9344 "2024-07-25T00:21:18Z")\
**Posts on this page:** 3\
**Page:** 1

<div class="post-metadata">

**Author:** ![cmdr-nova](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/cmdr-nova/32/6024_2.png) [@cmdr-nova](https://talk.jekyllrb.com/u/cmdr-nova)\
**Post date:** [July 25, 2024, 12:21am UTC](https://talk.jekyllrb.com/t/pagination-broken-instructions-make-no-sense/9344/1 "2024-07-25T00:21:18Z")

</div>

I’ve followed the instructions on this page top to bottom, nothing works. I don’t know if it’s because I’m on Github Pages with this, or because people just don’t know how to write instructions.

> **[Pagination](https://jekyllrb.com/docs/pagination/)**
>
> With many websites — especially blogs — it’s very common to break the main listing of posts up into smaller lists and display them over multiple pages. Jekyll offers a pagination plugin, so you can automatically generate the appropriate files and...

I’m not trying to use paginate with collections, or categories, or anything. I just want 5 posts per page, and a next button.

Absolutely nothing works

I’ve tried 40 combinations of different things people use in config.yml

Nothing

I’ve tried making an index.html file in multiple folders including the root folder

Nothing, nothing, nothing.

I work a full time job, and I’ve spent my free time outside of work exclusively trying to figure this out, and I’m no further ahead on this issue than I was when I began.

I’m at the end of my rope.

---

<div class="post-metadata">

**Author:** ![rdyar](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/rdyar/32/710_2.png) [@rdyar](https://talk.jekyllrb.com/u/rdyar)\
**Post date:** [July 27, 2024, 3:12am UTC](https://talk.jekyllrb.com/t/pagination-broken-instructions-make-no-sense/9344/2 "2024-07-27T03:12:39Z")

</div>

I’ve never used pagination (for real), but the one time I set it up to play with it the bit about it only working on an index.html page was very literal. Like it only worked on the root index.html page as I remember.

Are you using the pagination v1? it should work on GH pages but the V2 paginator doesn’t work unless you build via actions or whatever that way is.

Do you have a repo to share?

when it doesn’t work do you get an error? or it just doesn’t work?

---

<div class="post-metadata">

**Author:** ![george-gca](https://yyz2.discourse-cdn.com/flex030/user_avatar/talk.jekyllrb.com/george-gca/32/5301_2.png) [@george-gca](https://talk.jekyllrb.com/u/george-gca)\
**Post date:** [July 30, 2024, 1:29pm UTC](https://talk.jekyllrb.com/t/pagination-broken-instructions-make-no-sense/9344/3 "2024-07-30T13:29:44Z")

</div>

In [this repo](https://github.com/alshedivat/al-folio), [jekyll-paginate-v2](https://github.com/sverrirs/jekyll-paginate-v2) is used to handle pagination for the [blog page](https://alshedivat.github.io/al-folio/blog/). You can check the source code for the [blog](https://github.com/alshedivat/al-folio/blob/master/_pages/blog.md) and also for the [pagination part of it](https://github.com/alshedivat/al-folio/blob/master/_includes/pagination.liquid).