Skip to main content Link Menu Expand (external link) Document Search Copy Copied

Offset Page Pattern

The Offset Page pattern adds pagination affordances to resources that have multiple elements. The List pattern often applies the Offset Page pattern, giving clients control over pagination of the list’s elements.

The Paged resource (such as a List resource) has a link to a Page Info resource that describes the pagination configuration. The Paged resource also has links to the previous and next pages as defined in the base Page pattern. Clients can change the pagination configuration with the Pagination resource.

Changing Offset Paging Configuration

The client changes page configuration by POSTing a new configuration to the Pagination resource. This configuration contains the page size and starting page. Pagination responds to the POST by returning a newly-configured Paged resource URI in the location response header. The client redirects to this URI to start paging through the elements. See the Pagination resource for more information.

Paged Resource

profile: <>

See the documentation for Paged resource.



Points to a Page Info resource that describes the Paged resource’s pagination configuration.

Page Info Resource

profile: <>

The Page Info resource describes the pagination configuration used in the Paged resource. This resource has relevant state fields describing the current page, page size and total pages count to help the client determine which page the Paged resource represents.

Property Purpose
current The current page. Page numbers are 1-based.
pages The number of pages in the Paged resource. May be unknown, so a client will need to accept text statements in this property.
size The number of elements per page.



Points to a Pagination resource that can configure the pagination.

Pagination Resource

profile: <>

The Pagination resource is a Lookup resource that changes the pagination offset configuration. The client can change the page size or the start page so the client can select a different page to view. Once the client submits the lookup, the client redirects to a Paged resource configured with this configuration.

Property Purpose
size The number of elements per page.
start The starting page for the Paged view. Clients use this property to control what page to view. This value is 1-based, and if it is greater than the maximum pages available in the result set then the last page will be set as the start page in the response.



Points to the Paged resource that this Pagination resource configures.

© 2019-2023 Matt Bishop
Creative Commons Licence
This work is licensed under a Creative Commons Attribution-NoDerivatives 4.0 International License.