¶ Pagination and Collection Pages
Pagination lets a single page generate multiple published pages from a data source
This is how Silex implements collection pages, similar to Webflow or other CMS-driven builders
Under the hood, this follows 11ty pagination concepts
If you already know 11ty, this maps directly to its pagination system
You can also refer to 11ty’s documentation for the full data model
https://www.11ty.dev/docs/pagination/
¶ Core Concepts
- Pagination turns one page into many pages
- Each generated page represents one item (or a group of items) from a data source
- The page template stays the same, only the data changes
- URLs are defined dynamically using expressions
Here are the Page settings:
¶ Pagination Data
Pagination Data defines what data is used to generate pages
- This field expects an expression
- The expression must resolve to an array
- Each element of the array represents one page (or one group of pages)
When Pagination Data is set, the page becomes a collection page
Examples of valid pagination data
- A list of CMS entries
- An array returned by an API
- Any expression that resolves to an array
¶ Pagination Size
Pagination Size defines how many items are included per generated page
- size =
1means one page per item - size >
1groups multiple items into one page
For classic collection pages, size is usually set to 1
¶ Permalink
Permalink defines the published path of the page
- This field expects an expression
- The expression is evaluated once per generated page
- It must resolve to a string
For collection pages, the permalink usually depends on the current item
Example
pagination.items | first > title | slugify
¶ Pagination Items
When pagination is enabled, additional data becomes available
pagination.itemsis the array of items for the current page- When size = 1,
pagination.items[0]is the item represented by this page - These values can be used in permalinks and in the page content
This follows the standard 11ty pagination data model
¶ Making a Collection Page
- Open Page Settings > CMS
- Set a Pagination Data expression that resolves to an array
- Set Pagination Size, usually
1 - Set a Permalink expression based on
pagination.items - Publish and build the site
Silex will automatically generate one published page per paginated item