is pagination not possible any more?

[mykelscappin]

Describe the bug

pagination does not seem to be possible in redoc anymore

im following the instructions at https://redocly.com/docs-legacy/api-reference-docs/configuration/functionality but it doesnt do anything

To Reproduce

this syntax:

  rest-v1:
    root: rest/v1/openapi/api_v1.yaml
    openapi:
      htmlTemplate: redoc_template/index.php
      theme:
        pagination: item

results in:

[1] redocly.yaml:8:9 at #/apis/rest-v1/openapi/theme/pagination

Property `pagination` is not expected here.

Warning was generated by the configuration struct rule.

---

and this syntax:

  rest-v1:
    root: rest/v1/openapi/api_v1.yaml
    openapi:
      htmlTemplate: redoc_template/index.php
      pagination: item

doesnt cause an error in validation, but also does not work on the generated output

Expected behavior

pagination should work

Logs

n/a

OpenAPI description

openapi: 3.1.0

Redocly version(s)

2.14.3 and also 2.15.1

Node.js version(s)

node v23.7.0
npm 10.9.2

OS, environment

MacOS Tahoe 26.2 (25C56)

Additional context

i know redoc has lately made tonnes of changes around the openapi property & theme support

it would be nice if the docs kept up :'(

[tatomyr]

I believe, the first syntax should still work as we maintain backward compatibility, and you can ignore the warning for the time being. I'll check what's wrong.

cc @Redocly/keyboard-warriors @JLekawa

[tatomyr]

@mykelscappin oh, you're using the legacy docs version. Only our legacy Reference Docs product uses pagination. Redoc/Redoc CE don't support it.

[mykelscappin]

@tatomyr can you please help explain or link to what the product differences are, as it is VERY unclear. feels like redoc (open source?) is trying to get people to use redocly (SaaS) and features are just shifting to the paid version...

and then, what's the community edition? 😮‍💨

---

which product should i use for pagination support

[tatomyr]

@mykelscappin it's a question more about Redoc rather than the CLI... @AlexVarchuk could you assist?

[AlexVarchuk]

Hi @mykelscappin,
Thank you for your question.
We apologize for the lack of clarity in our documentation.
We do our best, but unfortunately, we lack the capacity to implement changes and develop new features as quickly as we would like.

In short, CE Redoc never supported pagination. However, pagination will be available in the enterprise product until the end of February 2026.

I will try to provide some context about the pagination feature.

We have a legacy product that includes an API registry. Only this part supports pagination, but it will be retired on February 28, 2026.
More than a year ago, Redocly launched new, more powerful, paid products that can be used to create simple and complex documentation. However, we believe that pagination adds unnecessary complexity.

The open-source component is CE Redoc, and we are currently working on the next major release. We have a release candidate, but we have encountered major issues and need more time to resolve them. As a result, the community will receive a product with better user experience (UX), performance, and functionality without pagination. We don't recommend using the pagination option at all.

Please describe your case, setup, and the purpose for which you need pagination. I'll try to help you accomplish your goal.