How to use pagination

Control how many items display at once and let visitors load more.

Setting Up Pagination

1. Open your widget in the designer
2. Go to the Filters tab in the right sidebar
3. Expand the Pagination section
4. Set your items per page

Pagination Settings

Items Per Page

Set how many items to show before displaying the “Show more” button:

• Maximum: 100 items (after that users will need to click show more)

Max Items

Limit the total number of items that appear on your widget. This is separate from “items per page” — it caps how many items visitors can ever see, regardless of how many times they click “Show more.”

• Default: 1000 (the maximum)
• Range: 1 to 1000
• Set a lower number to only show a subset of your data (e.g. show only the 20 most recent items)

How pagination works

When your widget has more items than the “items per page” setting:

1. The first batch of items displays immediately
2. A “Show more” button appears below the items
3. Clicking the button loads the next batch
4. This continues until all items are displayed

Show More Button

• Customise the text shown on the load more button. Leave blank to use the default text for your widget language
• Click the paintbrush icon next to the button text to customise the button appearance, Text colour, Background colour, Size and Shape

Empty State

Customise what visitors see when no data matches their search or filters.

Setting Up Empty State

1. Open your widget in the designer
2. Go to the Filters tab in the right sidebar
3. Expand the Empty State section
4. Toggle it on and enter your custom message

Default Message

By default, visitors see “No results found” when search or filters return no matches.

Customising the Message

You can add custom text with basic formatting to help guide visitors:

• “No matches found - try adjusting your filters”
• “Nothing here yet - check back soon”
• “No products match your criteria - try removing some filters”