Bootstrap Paginator is a jQuery plugin that simplifies the rendering of Bootstrap Pagination component

  • By Yun Lai
  • Last update: Jan 2, 2023
  • Comments: 6

Bootstrap Paginator v1.0

Bootstrap Paginator is a jQuery plugin that simplifies the rendering of Bootstrap Pagination component. It provides methods to automates the update of the pagination status and also some events to notify the status changes within the component. For documentation and examples, please visit Bootstrap Paginator Website.


v 1.0

  • Add the support for bootstrap v3.
  • Make the page change happened in page click event stoppable
  • Remove the visibility control within getPages function and leave it with shouldShowPage function.

v 0.6

  • Fix the bug that will cause page out of range when updating the current page together with the total pages.

v 0.5.1

  • Use html entities in default text function instead of plain text to fix the display problem in IE 7-9

Copyright and License

Copyright 2013 Yun Lai

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.



  • 1

    Documentation of API?

    The original website ( for this project is down, and the documentation on this branch hasn't been updated in some time.

    I'm having compatibility issues trying to upgrade to Bootstrap v3, and it's hard to know where things are going wrong.

    Can anyone help me with the following code?

    //now change .pagination
    var options = {
        currentPage: currentPage,
        totalPages: totalPages,
        onPageClicked: function(e, originalEvent, type, page) {
  • 2

    Fix bug when first/next/prev/last were set to be "on" all the time

    I wanted a configuration where the first/prev/next/last buttons were on all the time, but since the 1 was being passed in as the page number for these buttons, they would be marked as active when the first or last page was active.

    This checks that the element we are adding "active" to is actually a "page"...

  • 3

    Add class to
      by specifying option

    I would like to specify an additional class to the < ul > when the pagination control is generated.

    Can this already be done? I know that it can be done to each < li > element for the page numbers. Otherwise I'll submit a pull request

  • 4

    Doesn't go over 10000 pages

    Lets suppose I have a pagination result with more than 10000 pages, lets say 15000.

    When I click to go to the last page, instead of showing the last page as 15000, it shows 10000.

    I took a look at the code but couldn't figure it out.

  • 5

    Added updateIndicatorOnClick option. Updated documentation

    When pageUrl is set, and the page refreshes on click, I noticed that the paginator gets updated immediately, and if the page takes a little time to load, it just looks wrong. Therefore, I added an option that allows the user to turn off the switching of the page indicator immediately on click. I also updated the documentation.

  • 6

    Requesting permission to run official fork

    As a lot of people who use this plugin have likely realised, this repo is no longer maintained. However there are still a lot of people willing to contribute to it.

    I am asking permission from @lyonlai to maintain an official fork for people to help make this plugin better with their contributions.

    Anybody who wants to help contribute, I will be maintaining the fork anyway, regardless of whether it's official. So please feel free to re-submit your PRs.

    The docs have been fixed (CNAME & GitHub pages SSL) -