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 for a full guide on using this hook.
Usage Example
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.Reputation
Theconfig object passed to fetchEntities accepts an optional spaceReputation object that opts each row’s embedded author into an added spaceReputation number. See Reputation.
Opt-in. Adds a
spaceReputation number to each row’s embedded author. This object is the primary form — it replaces the deprecated flat config props below. This is a context surface, so spaceId accepts "context".Deprecated — use
config.spaceReputation.spaceId. The flat form; still accepted (the object wins if both are passed). Accepts a space <uuid>, "none", or "context".Deprecated — use
config.spaceReputation.includeDescendants. Only honored alongside an explicit config.spaceReputationId <uuid>.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 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.

