> ## Documentation Index
> Fetch the complete documentation index at: https://docs.replyke.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Use entity list
> Manage a paginated entity feed with filtering, sorting, and infinite scroll
## Overview
`useEntityList` is the primary hook for building entity feeds. Each call receives a unique `listId` that namespaces its Redux state, so multiple independent lists can coexist on the same page.
See [Fetching Entities](/sdk/entity-lists/fetch-entities) for a full guide on using this hook.
## Usage Example
```tsx theme={null}
import { useEntityList } from "@replyke/react-js";
import { useEffect } from "react";
function Feed() {
const {
entities,
loading,
hasMore,
fetchEntities,
loadMore,
} = useEntityList({ listId: "main-feed" });
useEffect(() => {
fetchEntities({}, { sortBy: "hot" }, { limit: 20, include: ["user"] });
}, []);
return (
<>
{entities.map((e) =>
{e.title}
)}
{hasMore && }
);
}
```
## Props
Unique identifier for this list. Used to namespace Redux state. Must be stable across renders.
Optional. A function called for each entity with a `foreignId`. Its result is merged into the entity under an `infusion` key. See [Infusing Data](/sdk/entity-lists/infuse-data).
## Return Values
The current list of loaded entities.
Entities merged with data from `infuseData`. Empty array if `infuseData` was not provided.
`true` while a fetch or load-more is in progress.
`true` when there are more pages to load.
Loads the first page with the given filters, sort, and config. Debounced by default (800ms). See [Fetching Entities](/sdk/entity-lists/fetch-entities) for the full parameter reference.
Appends the next page of results. Must be called after `fetchEntities` has been invoked at least once.
Creates a new entity and inserts it into the list. Accepts the same fields as `useCreateEntity`, plus `insertPosition: "first" | "last"`.
Deletes an entity and removes it from the local list state.
Current sort algorithm.
Current reaction sort type (used when `sortBy` is `"top"`).
Current sort direction.
Current sort type hint for metadata sorts.
Active time frame filter.
Active source ID filter (from config).
Active user ID filter.
Whether the followed-only filter is active.
Active keywords filter.
Active title filter.
Active content filter.
Active attachments filter.
Active location filter.
Active metadata filter.