AttRibutes
List Load
What is this page about?

Attributes, by Finsweet, offers a free series of Solutions that provide essential features to improve your Webflow websites.

List Load

Set up powerful load functionality on Webflow CMS Collection Lists. Load more, infinite scroll, pagination, and render all items.

List Load • Flash Card

Copy Script

For advanced users familiar with this solution. Includes all attributes from this page. Click on attributes and values to copy them.

Required attributes

List

Add to Collection List

fs-list-element
=
"
list
"

List loading method

Add to Collection List, chose only one method as the value among: more, all, infinite, pagination

fs-list-load
=
"
VALUE
"

Optional count attributes (for all loading methods)

Items-count

Add to Text Block

fs-list-element
=
"
items-count
"

Visible count

Add to Text Block

fs-list-element
=
"
visible-count
"

Visible count from

Add to Text Block

fs-list-element
=
"
visible-count-from
"

Visible count to

Add to Text Block

fs-list-element
=
"
visible-count-to
"

Optional animation attributes (for all loading methods)

Animation

Add to element with fs-list-element="list"
Chose a value among: fade, slide-up, slide-down, slide-right, slide-left, grow, shrink or spin

fs-list-animation
=
"
VALUE
"

Easing

Add to element with fs-list-element="list"
Chose a value among: linear, ease, ease-in, ease-out, ease-in-out

fs-list-easing
=
"
VALUE
"

Duration

Add to element with fs-list-element="list"

fs-list-duration
=
"
TIME_IN_MS
"

Stagger load

Add to element with fs-list-element="list"

fs-list-stagger
=
"
TIME_IN_MS
"

Reset interactions

Add to element with fs-list-element="list"

fs-cmsload-resetix
=
"
true
"

Disable cache

Add to element with fs-list-element="list"

fs-list-cache
=
"
false
"

Optional attributes (for infinite load method)

Loader

Add to Image, Embed, Lottie

fs-list-element
=
"
loader
"

Threshold

Add to element with fs-list-element="list"

fs-list-threshold
=
"
NUMBER
"

Optional attributes (for pagination load method)

Scroll Anchor

Add to Div Block

fs-list-element
=
"
scroll-anchor
"

Page Button

Add to Button, Link Block, Text Link

fs-list-element
=
"
page-button
"

Page Dots

Add to Div Block, Text Block

fs-list-element
=
"
page-dots
"
1

Add this <script> inside the <head> tag of your page or project

This script is the universal Attribute script: you only need to include it once, even if you have multiple Attribute solutions on the page. Learn more .

<script async type="module"
src="https://cdn.jsdelivr.net/npm/@finsweet/attributes@2/attributes.js"
fs-list
></script>

Copy Script
2

Choose the loading method you want

3

Add these required attributes to the elements

List

The list to which loading options will be added
fs-list-element
=
"
list
"

Add the fs-list-element="list" custom attribute to define the list getting the loading feature.

Add this attribute:
Name
fs-list-element
Copy
Value
list
Copy
Add it to those type(s) of element(s):
Collection List
NOTE

In case you want to use non-CMS content, replicate the CMS structure using div blocks as follows:

Learn everything about using a non-CMS list with the List Solutions on How to use List Solutions on static lists.

Mode: Load More

Defines the ‘Load More’ mode for the list
fs-list-load
=
"
more
"

Add the fs-list-load="more" on your List to define this loading method.

Add this attribute:
Name
fs-list-load
Copy
Value
more
Copy
Add it to any element with
fs-list-element = "list"
4

Ensure that the native Webflow pagination is enabled

Enable 'Paginate Items'

With your Collection List selected, open the Settings panel and check the 'Paginate Items' option.

Use the Next button from the native Webflow pagination settings as the trigger for the Load More functionality.

Customize the button text — e.g.; "Load More", "See more posts" — and style to match your design requirements.

NOTE

The number of items per page in the ‘Paginate Items’ settings determines how many items will be loaded when the user clicks on ‘Load More’.

NOTE

When using a non-CMS structure for pagination, set the attribute fs-list-itemsperpage = "NUMBER_OF_ITEMS" to specify the number of items initially visible and loaded each time users click the "Load More" button.

Enable 'Show Page Count' to boost loading speed for the items

Select the Pagination, open the Settings panel and check the 'Show Page Count' option.

With this setting enabled, Attributes can optimize your load based on your page count. The page count element can be visible or hidden on the page.

NOTE

When using a non-CMS structure, set the attribute ⁠fs-list-element = "page-count" on a Text Block element to display the page count.

5

Publish your project! Done, easy right?

Check more elements and settings below
Optional

Add more

elements

Items Count

Shows the total number of items of the Collection List
fs-list-element
=
"
items-count
"

Add this attirbute to the element showing the total number of items of the list.

Add this attribute:
Name
fs-list-element
Copy
Value
items-count
Copy
Add it to those type(s) of element(s):
Text Block
EXAMPLE

If there are 125 items in the Collection, and there is no "Limit" set on the Collection List Settings, this text element will display "125".

Visible Count

Shows the total number of items in the view
fs-list-element
=
"
visible-count
"

This will show the total number of items that are currently visible in the list.

Add this attribute:
Name
fs-list-element
Copy
Value
visible-count
Copy
Add it to those type(s) of element(s):
Text Block
NOTE

This will not count filtered results that are behind a "Load More" button or an infinite scroll setup. This attribute only counts the amount of items that are visible in the user's UI.

Visible Count From

The "from" value in the range of items that are visible
fs-list-element
=
"
visible-count-from
"

This will show the "from" value in the range of items that are currently visible in the list.

Add this attribute:
Name
fs-list-element
Copy
Value
visible-count-from
Copy
Add it to those type(s) of element(s):
Text Block
EXAMPLE

For example, if the list is currently displaying items from 4 to 10, this Text Block will display "4".

Visible Count To

The "to" value in the range of items that are visible
fs-list-element
=
"
visible-count-to
"

This will show the "to" value in the range of items that are currently visible in the list.

Add this attribute:
Name
fs-list-element
Copy
Value
visible-count-to
Copy
Add it to those type(s) of element(s):
Text Block
NOTE

For example, if the list is currently showing items from 4 to 10, this Text Block will display "10".

Optional

Add more

settings

Load Count

Defines how many items to load
fs-list-loadcount
=
"
NUMBER
"
Values allowed

Defines the number of items to load when clicking the ‘Load More’ button.

Add this attribute:
Name
fs-list-loadcount
Copy
Value
NUMBER
Copy
Example:
fs-list-loadcount = "3"
Default:
The default number of items to be loaded is the items per page in Paginate Items.
Add it to any element with
fs-list-element = "list"

Load all items when the ‘Load more’ button is clicked.

Add this attribute:
Name
fs-list-loadcount
Copy
Value
all
Copy
Add it to any element with
fs-list-element = "list"

Reset Interactions

Use interactions on Collection List Items
fs-list-resetix
=
"
true
"

If you are using interactions on Collection List Items (or any child of them), they won't work on the newly loaded items unless you apply this attribute to the Collection List.

Add this attribute:
Name
fs-list-resetix
Copy
Value
true
Copy
Add it to any element with
fs-list-element = "list"
WARNING

When using this attribute, all interactions that have an Initial State will be restored to it, use with caution to avoid unexpected UX behaviors.

Animate the List

Define CSS animations on the List when loading is triggered
fs-list-loadingclass
=
"
CLASS_NAME
"

List animations are fully controlled through CSS.

When a list is filtered—or sorted, or paginated—temporary classes are applied to the Collection List Wrapper to trigger transitions or animations, and then removed once the action completes.

This system supports per-action animation, per-item staggering, and precise control via CSS.

  • During a load action, the .is-list-loading class is added to the Collection List Wrapper. It is removed once the action completes.
  • fs-list detects any CSS transitions triggered by the class and waits for them to finish before updating the list.
  • The class can be renamed using the attribute fs-list-loadingclass.
Add this attribute:
Name
fs-list-loadingclass
Copy
Value
CLASS_NAME
Copy
Default:
fs-list-filteringclass = "is-list-loading"
Example:
fs-list-loadingclass = "my-loading-class"
Add it to this type of element
Collection List Wrapper
script icon
Script tag
NOTE

Please refer to the List Sort and List Load documentation pages for animating the List when it's sorted or loaded.

Animate the List Items

Define CSS animations on the List Items when they are rendered
fs-list-startingclass
=
"
CLASS_NAME
"

List items animations are fully controlled through CSS.

Before an item is rendered to the list a temporary class is applied to the Collection List Item, and then removed once the item has been rendered. This allows to trigger CSS transitions simulating a similar behavior to @starting-style.

  • Before rendering an item, the .is-list-starting class is added to the Collection List Item. It is removed once the item is present in the DOM.
  • fs-list detects any CSS transitions triggered by the class removal and waits for them to finish before updating the list.
  • The class can be renamed using the attribute fs-list-startingclass.
Add this attribute:
Name
fs-list-startingclass
Copy
Value
CLASS_NAME
Copy
Default:
fs-list-startingclass = "is-list-starting"
Example:
fs-list-startingclass = "my-custom-class"
Add it to this type of element
Collection List Wrapper
script icon
Script tag

Stagger Load

Add stagger animation when loading the content
fs-list-stagger
=
"
TIME_IN_MS
"

This option adds a stagger animation to the items in the List. The value is the time in milliseconds between each loaded item.

A stagger animation is a technique used in animation and web design where multiple elements are animated with slight delays between them. This creates a sequence effect that makes elements appear or move one after another, rather than all at once.

Add this attribute:
Name
fs-list-stagger
Copy
Value
TIME_IN_MS
Copy
Example:
fs-list-stagger = "200"
Default value:
fs-list-stagger = "100"
Add it to any element with
fs-list-element = "list"

Disable Caching

Disable caching for loaded items
fs-list-cache
=
"
false
"

By default, List Load caches the fetched documents for performance, and the cache doesn't expire until the site is re-published.

There are some times where you might want to opt out of this behavior, like when you programmatically update your CMS Collections via the Webflow CMS API without manually publishing the site.

Add this attribute:
Name
fs-list-cache
Copy
Value
false
Copy
Default value:
fs-list-cache = "true"
Add it to any element with
fs-list-element = "list"
3

Add these required attributes to the elements

List

The list to which loading options will be added
fs-list-element
=
"
list
"

Add the fs-list-element="list" custom attribute to define the list getting the loading feature.

Add this attribute:
Name
fs-list-element
Copy
Value
list
Copy
Add it to those type(s) of element(s):
Collection List
NOTE

In case you want to use non-CMS content, replicate the CMS structure using div blocks as follows:

Learn everything about using a non-CMS list with the List Solutions on How to use List Solutions on static lists.

Mode: Render All

Defines the ‘Render All’ mode for the list
fs-list-load
=
"
all
"

Add the fs-list-load="all" on the List on which you want the loading feature.

This option allows for the rendering of ALL items in your Collection, surpassing the typical 100 items limit per Collection List.

For instance, if your Collection contains 5,488 items, this setting will load and display all 5,488 items on the page.

Add this attribute:
Name
fs-list-load
Copy
Value
all
Copy
Add it to any element with
fs-list-element = "list"
WARNING

Please consider the user experience carefully. Loading thousands of items at once may result in poor performance, particularly for users on mobile connections. It's advisable to use this feature only when absolutely necessary. For better performance, especially when using List Filter, consider using Pagination mode instead of Render All.

4

Ensure that the native Webflow pagination is enabled

Enable 'Paginate Items'

With your Collection List selected, open the Settings panel and check the 'Paginate Items' option.

Enabling the native 'Paginate Items' in Webflow is a mandatory step, as our solution uses pagination to identify additional items that need to be loaded.

NOTE

To ensure the pagination does not appear on the page, select the pagination element and set display: none.

Enable 'Show Page Count' to boost loading speed for the items

Select the Pagination, open the Settings panel and check the 'Show Page Count' option.

With this setting enabled, Attributes can optimize your load based on your page count. The page count element can be visible or hidden on the page.

NOTE

When using a non-CMS structure, set the attribute ⁠fs-list-element = "page-count" on a Text Block element to display the page count.

5

Publish your project! Done, easy right?

Check more elements and settings below
Optional

Add more

elements

Items Count

Shows the total number of items of the Collection List
fs-list-element
=
"
items-count
"

Add this attirbute to the element showing the total number of items of the list.

Add this attribute:
Name
fs-list-element
Copy
Value
items-count
Copy
Add it to those type(s) of element(s):
Text Block
EXAMPLE

If there are 125 items in the Collection, and there is no "Limit" set on the Collection List Settings, this text element will display "125".

Visible Count

Shows the total number of items in the view
fs-list-element
=
"
visible-count
"

This will show the total number of items that are currently visible in the list.

Add this attribute:
Name
fs-list-element
Copy
Value
visible-count
Copy
Add it to those type(s) of element(s):
Text Block
NOTE

This will not count filtered results that are behind a "Load More" button or an infinite scroll setup. This attribute only counts the amount of items that are visible in the user's UI.

Visible Count From

The "from" value in the range of items that are visible
fs-list-element
=
"
visible-count-from
"

This will show the "from" value in the range of items that are currently visible in the list.

Add this attribute:
Name
fs-list-element
Copy
Value
visible-count-from
Copy
Add it to those type(s) of element(s):
Text Block
EXAMPLE

For example, if the list is currently displaying items from 4 to 10, this Text Block will display "4".

Visible Count To

The "to" value in the range of items that are visible
fs-list-element
=
"
visible-count-to
"

This will show the "to" value in the range of items that are currently visible in the list.

Add this attribute:
Name
fs-list-element
Copy
Value
visible-count-to
Copy
Add it to those type(s) of element(s):
Text Block
NOTE

For example, if the list is currently showing items from 4 to 10, this Text Block will display "10".

Optional

Add more

settings

Reset Interactions

Use interactions on Collection List Items
fs-list-resetix
=
"
true
"

If you are using interactions on Collection List Items (or any child of them), they won't work on the newly loaded items unless you apply this attribute to the Collection List.

Add this attribute:
Name
fs-list-resetix
Copy
Value
true
Copy
Add it to any element with
fs-list-element = "list"
WARNING

When using this attribute, all interactions that have an Initial State will be restored to it, use with caution to avoid unexpected UX behaviors.

Animate the List

Define CSS animations on the List when loading is triggered
fs-list-loadingclass
=
"
CLASS_NAME
"

List animations are fully controlled through CSS.

When a list is filtered—or sorted, or paginated—temporary classes are applied to the Collection List Wrapper to trigger transitions or animations, and then removed once the action completes.

This system supports per-action animation, per-item staggering, and precise control via CSS.

  • During a load action, the .is-list-loading class is added to the Collection List Wrapper. It is removed once the action completes.
  • fs-list detects any CSS transitions triggered by the class and waits for them to finish before updating the list.
  • The class can be renamed using the attribute fs-list-loadingclass.
Add this attribute:
Name
fs-list-loadingclass
Copy
Value
CLASS_NAME
Copy
Default:
fs-list-filteringclass = "is-list-loading"
Example:
fs-list-loadingclass = "my-loading-class"
Add it to this type of element
Collection List Wrapper
script icon
Script tag
NOTE

Please refer to the List Sort and List Load documentation pages for animating the List when it's sorted or loaded.

Animate the List Items

Define CSS animations on the List Items when they are rendered
fs-list-startingclass
=
"
CLASS_NAME
"

List items animations are fully controlled through CSS.

Before an item is rendered to the list a temporary class is applied to the Collection List Item, and then removed once the item has been rendered. This allows to trigger CSS transitions simulating a similar behavior to @starting-style.

  • Before rendering an item, the .is-list-starting class is added to the Collection List Item. It is removed once the item is present in the DOM.
  • fs-list detects any CSS transitions triggered by the class removal and waits for them to finish before updating the list.
  • The class can be renamed using the attribute fs-list-startingclass.
Add this attribute:
Name
fs-list-startingclass
Copy
Value
CLASS_NAME
Copy
Default:
fs-list-startingclass = "is-list-starting"
Example:
fs-list-startingclass = "my-custom-class"
Add it to this type of element
Collection List Wrapper
script icon
Script tag

Stagger Load

Add stagger animation when loading the content
fs-list-stagger
=
"
TIME_IN_MS
"

This option adds a stagger animation to the items in the List. The value is the time in milliseconds between each loaded item.

A stagger animation is a technique used in animation and web design where multiple elements are animated with slight delays between them. This creates a sequence effect that makes elements appear or move one after another, rather than all at once.

Add this attribute:
Name
fs-list-stagger
Copy
Value
TIME_IN_MS
Copy
Example:
fs-list-stagger = "200"
Default value:
fs-list-stagger = "100"
Add it to any element with
fs-list-element = "list"

Disable Caching

Disable caching for loaded items
fs-list-cache
=
"
false
"

By default, List Load caches the fetched documents for performance, and the cache doesn't expire until the site is re-published.

There are some times where you might want to opt out of this behavior, like when you programmatically update your CMS Collections via the Webflow CMS API without manually publishing the site.

Add this attribute:
Name
fs-list-cache
Copy
Value
false
Copy
Default value:
fs-list-cache = "true"
Add it to any element with
fs-list-element = "list"
3

Add these required attributes to the elements

List

The list to which loading options will be added
fs-list-element
=
"
list
"

Add the fs-list-element="list" custom attribute to define the list getting the loading feature.

Add this attribute:
Name
fs-list-element
Copy
Value
list
Copy
Add it to those type(s) of element(s):
Collection List
NOTE

In case you want to use non-CMS content, replicate the CMS structure using div blocks as follows:

Learn everything about using a non-CMS list with the List Solutions on How to use List Solutions on static lists.

Mode: Infinite Load

Defines the ‘Infinite’ mode for the list
fs-list-load
=
"
infinite
"

Add the fs-list-load="infinite" on the Collection List getting the loading feature.

This option activates an automatic infinite scroll for your List. As users scroll down the page, additional items will continuously load.

Add this attribute:
Name
fs-list-load
Copy
Value
infinite
Copy
Add it to any element with
fs-list-element = "list"
IMPORTANT

In order for the automatic loading to be triggered, the bottom of the list must overflow the viewport. If your list is too short and is displayed entirely in the viewport, the automatic loading won't be triggered.

4

Ensure that the native Webflow pagination is enabled

Enable Paginate Items

With your List selected, open the Settings panel and check the 'Paginate Items' option.

NOTE

The number of items per page in the ‘Paginate Items’ settings determines how many items will be loaded when the user reaches the end of the list.

NOTE

When using a non-CMS structure for pagination, set the attribute fs-list-itemsperpage = "NUMBER_OF_ITEMS" to specify the number of items initially visible and loaded each time user reaches the end of the list.

Enable 'Show Page Count' to boost loading speed for the items

Select the Pagination, open the Settings panel and check the 'Show Page Count' option.

With this setting enabled, Attributes can optimize your load based on your page count. The page count element can be visible or hidden on the page.

NOTE

When using a non-CMS structure, set the attribute ⁠fs-list-element = "page-count" on a Text Block element to display the page count.

5

Publish your project! Done, easy right?

Check more elements and settings below
Optional

Add more

elements

Loader

Shows the loading progress of the list
fs-list-element
=
"
loader
"

I want this element to be visible during the loading progress.When items are loading on the page, this element will be visible. When items are not loading on the page, this element will be hidden.

Add this attribute:
Name
fs-list-element
Copy
Value
loader
Copy
Add it to those type(s) of element(s):
Image
HTML Embed
Lottie Animation

Items Count

Shows the total number of items of the Collection List
fs-list-element
=
"
items-count
"

Add this attirbute to the element showing the total number of items of the list.

Add this attribute:
Name
fs-list-element
Copy
Value
items-count
Copy
Add it to those type(s) of element(s):
Text Block
EXAMPLE

If there are 125 items in the Collection, and there is no "Limit" set on the Collection List Settings, this text element will display "125".

Visible Count

Shows the total number of items in the view
fs-list-element
=
"
visible-count
"

This will show the total number of items that are currently visible in the list.

Add this attribute:
Name
fs-list-element
Copy
Value
visible-count
Copy
Add it to those type(s) of element(s):
Text Block
NOTE

This will not count filtered results that are behind a "Load More" button or an infinite scroll setup. This attribute only counts the amount of items that are visible in the user's UI.

Visible Count From

The "from" value in the range of items that are visible
fs-list-element
=
"
visible-count-from
"

This will show the "from" value in the range of items that are currently visible in the list.

Add this attribute:
Name
fs-list-element
Copy
Value
visible-count-from
Copy
Add it to those type(s) of element(s):
Text Block
EXAMPLE

For example, if the list is currently displaying items from 4 to 10, this Text Block will display "4".

Visible Count To

The "to" value in the range of items that are visible
fs-list-element
=
"
visible-count-to
"

This will show the "to" value in the range of items that are currently visible in the list.

Add this attribute:
Name
fs-list-element
Copy
Value
visible-count-to
Copy
Add it to those type(s) of element(s):
Text Block
NOTE

For example, if the list is currently showing items from 4 to 10, this Text Block will display "10".

Optional

Add more

settings

Load Count

Defines how many items to load
fs-list-loadcount
=
"
NUMBER
"
Values allowed

Defines the number of items to load when clicking the ‘Load More’ button.

Add this attribute:
Name
fs-list-loadcount
Copy
Value
NUMBER
Copy
Example:
fs-list-loadcount = "3"
Default:
The default number of items to be loaded is the items per page in Paginate Items.
Add it to any element with
fs-list-element = "list"

Load all items when the ‘Load more’ button is clicked.

Add this attribute:
Name
fs-list-loadcount
Copy
Value
all
Copy
Add it to any element with
fs-list-element = "list"

Threshold

Defines the threshold where more items will be rendered.
fs-list-threshold
=
"
NUMBER
"

Specifies the trigger point at which additional items will start loading and be displayed. This threshold determines when the Solution should load and render more content as required.

You can use any positive and negative number. The default is set to -20.

Add this attribute:
Name
fs-list-threshold
Copy
Value
NUMBER
Copy
Example:
fs-list-threshold = "10"
Default:
fs-list-threshold = "-20"
Add it to any element with
fs-list-element = "list"

Reset Interactions

Use interactions on Collection List Items
fs-list-resetix
=
"
true
"

If you are using interactions on Collection List Items (or any child of them), they won't work on the newly loaded items unless you apply this attribute to the Collection List.

Add this attribute:
Name
fs-list-resetix
Copy
Value
true
Copy
Add it to any element with
fs-list-element = "list"
WARNING

When using this attribute, all interactions that have an Initial State will be restored to it, use with caution to avoid unexpected UX behaviors.

Animate the List

Define CSS animations on the List when loading is triggered
fs-list-loadingclass
=
"
CLASS_NAME
"

List animations are fully controlled through CSS.

When a list is filtered—or sorted, or paginated—temporary classes are applied to the Collection List Wrapper to trigger transitions or animations, and then removed once the action completes.

This system supports per-action animation, per-item staggering, and precise control via CSS.

  • During a load action, the .is-list-loading class is added to the Collection List Wrapper. It is removed once the action completes.
  • fs-list detects any CSS transitions triggered by the class and waits for them to finish before updating the list.
  • The class can be renamed using the attribute fs-list-loadingclass.
Add this attribute:
Name
fs-list-loadingclass
Copy
Value
CLASS_NAME
Copy
Default:
fs-list-filteringclass = "is-list-loading"
Example:
fs-list-loadingclass = "my-loading-class"
Add it to this type of element
Collection List Wrapper
script icon
Script tag
NOTE

Please refer to the List Sort and List Load documentation pages for animating the List when it's sorted or loaded.

Animate the List Items

Define CSS animations on the List Items when they are rendered
fs-list-startingclass
=
"
CLASS_NAME
"

List items animations are fully controlled through CSS.

Before an item is rendered to the list a temporary class is applied to the Collection List Item, and then removed once the item has been rendered. This allows to trigger CSS transitions simulating a similar behavior to @starting-style.

  • Before rendering an item, the .is-list-starting class is added to the Collection List Item. It is removed once the item is present in the DOM.
  • fs-list detects any CSS transitions triggered by the class removal and waits for them to finish before updating the list.
  • The class can be renamed using the attribute fs-list-startingclass.
Add this attribute:
Name
fs-list-startingclass
Copy
Value
CLASS_NAME
Copy
Default:
fs-list-startingclass = "is-list-starting"
Example:
fs-list-startingclass = "my-custom-class"
Add it to this type of element
Collection List Wrapper
script icon
Script tag

Stagger Load

Add stagger animation when loading the content
fs-list-stagger
=
"
TIME_IN_MS
"

This option adds a stagger animation to the items in the List. The value is the time in milliseconds between each loaded item.

A stagger animation is a technique used in animation and web design where multiple elements are animated with slight delays between them. This creates a sequence effect that makes elements appear or move one after another, rather than all at once.

Add this attribute:
Name
fs-list-stagger
Copy
Value
TIME_IN_MS
Copy
Example:
fs-list-stagger = "200"
Default value:
fs-list-stagger = "100"
Add it to any element with
fs-list-element = "list"

Disable Caching

Disable caching for loaded items
fs-list-cache
=
"
false
"

By default, List Load caches the fetched documents for performance, and the cache doesn't expire until the site is re-published.

There are some times where you might want to opt out of this behavior, like when you programmatically update your CMS Collections via the Webflow CMS API without manually publishing the site.

Add this attribute:
Name
fs-list-cache
Copy
Value
false
Copy
Default value:
fs-list-cache = "true"
Add it to any element with
fs-list-element = "list"
3

Add these required attributes to the elements

List

The list to which loading options will be added
fs-list-element
=
"
list
"

Add the fs-list-element="list" custom attribute to define the list getting the loading feature.

Add this attribute:
Name
fs-list-element
Copy
Value
list
Copy
Add it to those type(s) of element(s):
Collection List
NOTE

In case you want to use non-CMS content, replicate the CMS structure using div blocks as follows:

Learn everything about using a non-CMS list with the List Solutions on How to use List Solutions on static lists.

Mode: Pagination

Defines the ‘Pagination’ mode for the list
fs-list-load
=
"
pagination
"

Add the fs-list-load="pagination" on the Collection List getting the Loading feature.

This setting allows you to enable same-page pagination for your Collection List.

Add this attribute:
Name
fs-list-load
Copy
Value
pagination
Copy
Add it to any element with
fs-list-element = "list"
4

Ensure that the native Webflow pagination is enabled

Enable 'Paginate Items'

With your List selected, open the Settings panel and check the 'Paginate Items' option.

Use the 'Next' and 'Previous' buttons from the native Webflow pagination settings for this feature. Customize their style to match your design needs.

WARNING

Avoid adding extra wrappers around the pagination buttons as it may cause the "Previous" button to disappear from your site.

NOTE

Control the disabled state of the next and previous buttons when no more pages are available by adding the combo class is-list-pagination-disabled.

NOTE

When using a non-CMS structure for pagination, set the attribute fs-list-itemsperpage = "NUMBER_OF_ITEMS" to specify the number of items initially visible and loaded on each page.

Enable 'Show Page Count' to boost loading speed for the items

Select the Pagination, open the Settings panel and check the 'Show Page Count' option.

With this setting enabled, Attributes can optimize your load based on your page count. The page count element can be visible or hidden on the page.

NOTE

When using a non-CMS structure, set the attribute ⁠fs-list-element = "page-count" on a Text Block element to display the page count.

5

Publish your project! Done, easy right?

Check more elements and settings below
Optional

Add more

elements

Items Count

Shows the total number of items of the Collection List
fs-list-element
=
"
items-count
"

Add this attirbute to the element showing the total number of items of the list.

Add this attribute:
Name
fs-list-element
Copy
Value
items-count
Copy
Add it to those type(s) of element(s):
Text Block
EXAMPLE

If there are 125 items in the Collection, and there is no "Limit" set on the Collection List Settings, this text element will display "125".

Visible Count

Shows the total number of items in the view
fs-list-element
=
"
visible-count
"

This will show the total number of items that are currently visible in the list.

Add this attribute:
Name
fs-list-element
Copy
Value
visible-count
Copy
Add it to those type(s) of element(s):
Text Block
NOTE

This will not count filtered results that are behind a "Load More" button or an infinite scroll setup. This attribute only counts the amount of items that are visible in the user's UI.

Visible Count From

The "from" value in the range of items that are visible
fs-list-element
=
"
visible-count-from
"

This will show the "from" value in the range of items that are currently visible in the list.

Add this attribute:
Name
fs-list-element
Copy
Value
visible-count-from
Copy
Add it to those type(s) of element(s):
Text Block
EXAMPLE

For example, if the list is currently displaying items from 4 to 10, this Text Block will display "4".

Visible Count To

The "to" value in the range of items that are visible
fs-list-element
=
"
visible-count-to
"

This will show the "to" value in the range of items that are currently visible in the list.

Add this attribute:
Name
fs-list-element
Copy
Value
visible-count-to
Copy
Add it to those type(s) of element(s):
Text Block
NOTE

For example, if the list is currently showing items from 4 to 10, this Text Block will display "10".

Scroll Anchor Pagination

Scroll the user to the top when the page changes
fs-list-element
=
"
scroll-anchor-pagination
"

By anchoring the scroll to the top of the page, it ensures that users consistently view content from the beginning of the list.

After the page changes, it will automatically scroll to the element on which you add this attribute.

Add this attribute:
Name
fs-list-element
Copy
Value
scroll-anchor-pagination
Copy
Add it to those type(s) of element(s):
Div Block
NOTE

We have an fs-list-element = "scroll-anchor" attribute for filtering, sorting, and loading. Use fs-list-element = "scroll-anchor-pagination" if you want the scroll-anchor to work only when the user interacts with pagination.

Page Button

Specifies the design template for customizing button styles.
fs-list-element
=
"
page-button
"

This element serves as the template for custom pagination page buttons.

If it is not included, pagination will default to using the native Webflow Next and Previous buttons.

Add this attribute:
Name
fs-list-element
Copy
Value
page-button
Copy
Add it to those type(s) of element(s):
Button
Link Block
Text Link
IMPORTANT

The element designated by fs-list-element="page-button" must be placed within a Div Block to function correctly and load additional pagination buttons.

NOTE

The current or active state of the page button is controlled using Webflow's Current state styling. To modify this state's style, temporarily set the button's URL to match the current page.

Page Dots

Specifies the design template for customizing the pagination ellipsis.
fs-list-element
=
"
page-dots
"

This element acts as the template for the "..." pagination dots.

Use this attribute to tailor the appearance of these dots. In the absence of this attribute, the default setting for the dots is <div>...</div>.

Add this attribute:
Name
fs-list-element
Copy
Value
page-dots
Copy
Add it to those type(s) of element(s):
Div Block
Text Block
NOTE

Dots in the pagination will appear only if there are sufficient pages in your list.

Specifically, dots are displayed when the total number of pages exceeds the sum of sibling pages, boundary pages, and the current active page. This ensures that dots are shown or hidden smartly, depending on the number of pages available in your pagination.

Optional

Add more

settings

Page Siblings

Sets how many sibling pages appear in the pagination
fs-list-pagesiblings
=
"
NUMBER
"

Specifies how many page numbers to display on each side of the current page in the pagination element.

This can be set as a comma-separated string that lists values in the order of Desktop, Tablet, Landscape, and Portrait.

Add this attribute:
Name
fs-list-pagesiblings
Copy
Value
NUMBER
Copy
Examples:
fs-list-pagesiblings = "2"
fs-list-pagesiblings = "4,3,3,2"
Default:
fs-list-pagesiblings = "1"
Add it to any element with
fs-list-element = "list"

Page Boundary

Sets the boundaries or the pagination element
fs-list-pageboundary
=
"
NUMBER
"

Specifies the number of pages to display at the beginning and end of a pagination element.

The settings can be arranged as a comma-separated string, listing values in the order of Desktop, Tablet, Landscape, and Portrait.

Add this attribute:
Name
fs-list-pageboundary
Copy
Value
NUMBER
Copy
Examples:
fs-list-pageboundary = "2"
fs-list-pageboundary = "2,2,1,1"
Default:
fs-list-pageboundary = "1"
Add it to any element with
fs-list-element = "list"

Disabled Next & Previous

Style the disabled state of the next and previous pagination buttons
is-list-pagination-disabled

Add the combo class is-list-pagination-disabled to the 'Next' and 'Previous' buttons of the pagination to style the disabled state.

The disabled state refers to when there are no more pages to be displayed for the user.

Add this class:
Class
is-list-pagination-disabled
Copy
Add it to 'Next' and 'Previous' buttons

Query Parameters

Adds query parametrs to the URL of hepage
fs-list-showquery
=
"
true
"

When enabled, the list's state—including sorting, pagination, and filtering—will be captured in the URL as query parameters.

Add this attribute:
Name
fs-list-showquery
Copy
Value
true
Copy
Default:
fs-list-showquery = "false"
Add it to any element with
fs-list-element = "list"

Items Per Page

Bypass pagination limit of 100 items per page.
fs-list-itemsperpage
=
"
NUMBER
"

When using Items Per Page, you can show more than 100 items per page using pagination. Currently, 100 items per page is a limitation of native pagination in Webflow.

Add this attribute:
Name
fs-list-itemsperpage
Copy
Value
NUMBER
Copy
Example:
fs-list-itemsperpage = "200"
Add it to those type(s) of element(s):
Pagination

Reset Interactions

Use interactions on Collection List Items
fs-list-resetix
=
"
true
"

If you are using interactions on Collection List Items (or any child of them), they won't work on the newly loaded items unless you apply this attribute to the Collection List.

Add this attribute:
Name
fs-list-resetix
Copy
Value
true
Copy
Add it to any element with
fs-list-element = "list"
WARNING

When using this attribute, all interactions that have an Initial State will be restored to it, use with caution to avoid unexpected UX behaviors.

Animate the List

Define CSS animations on the List when loading is triggered
fs-list-loadingclass
=
"
CLASS_NAME
"

List animations are fully controlled through CSS.

When a list is filtered—or sorted, or paginated—temporary classes are applied to the Collection List Wrapper to trigger transitions or animations, and then removed once the action completes.

This system supports per-action animation, per-item staggering, and precise control via CSS.

  • During a load action, the .is-list-loading class is added to the Collection List Wrapper. It is removed once the action completes.
  • fs-list detects any CSS transitions triggered by the class and waits for them to finish before updating the list.
  • The class can be renamed using the attribute fs-list-loadingclass.
Add this attribute:
Name
fs-list-loadingclass
Copy
Value
CLASS_NAME
Copy
Default:
fs-list-filteringclass = "is-list-loading"
Example:
fs-list-loadingclass = "my-loading-class"
Add it to this type of element
Collection List Wrapper
script icon
Script tag
NOTE

Please refer to the List Sort and List Load documentation pages for animating the List when it's sorted or loaded.

Animate the List Items

Define CSS animations on the List Items when they are rendered
fs-list-startingclass
=
"
CLASS_NAME
"

List items animations are fully controlled through CSS.

Before an item is rendered to the list a temporary class is applied to the Collection List Item, and then removed once the item has been rendered. This allows to trigger CSS transitions simulating a similar behavior to @starting-style.

  • Before rendering an item, the .is-list-starting class is added to the Collection List Item. It is removed once the item is present in the DOM.
  • fs-list detects any CSS transitions triggered by the class removal and waits for them to finish before updating the list.
  • The class can be renamed using the attribute fs-list-startingclass.
Add this attribute:
Name
fs-list-startingclass
Copy
Value
CLASS_NAME
Copy
Default:
fs-list-startingclass = "is-list-starting"
Example:
fs-list-startingclass = "my-custom-class"
Add it to this type of element
Collection List Wrapper
script icon
Script tag

Stagger Load

Add stagger animation when loading the content
fs-list-stagger
=
"
TIME_IN_MS
"

This option adds a stagger animation to the items in the List. The value is the time in milliseconds between each loaded item.

A stagger animation is a technique used in animation and web design where multiple elements are animated with slight delays between them. This creates a sequence effect that makes elements appear or move one after another, rather than all at once.

Add this attribute:
Name
fs-list-stagger
Copy
Value
TIME_IN_MS
Copy
Example:
fs-list-stagger = "200"
Default value:
fs-list-stagger = "100"
Add it to any element with
fs-list-element = "list"

Disable Caching

Disable caching for loaded items
fs-list-cache
=
"
false
"

By default, List Load caches the fetched documents for performance, and the cache doesn't expire until the site is re-published.

There are some times where you might want to opt out of this behavior, like when you programmatically update your CMS Collections via the Webflow CMS API without manually publishing the site.

Add this attribute:
Name
fs-list-cache
Copy
Value
false
Copy
Default value:
fs-list-cache = "true"
Add it to any element with
fs-list-element = "list"
Optional

Add more

Instances

Define an instance on a common parent wrapper

fs-list-instance
=
"
IDENTIFIER
"

If you wish to create multiple instances of this solution on the same page, please follow the steps below:

  1. Select a wrapper parent that contains all the elements of an instance.
  2. Add an -instance attribute to it, with a unique value.
  3. Repeat for every instance.
Add this attribute:
Name
fs-list-instance
Copy
Value
IDENTIFIER
Copy
Examples:
fs-list-instance = "1"
fs-list-instance = "2"
fs-list-instance = "blog"
fs-list-instance = "team"
Learn more ways to set up multiple instances and how it works

Still need help?