Blocked Users List
View all users you have blocked, including their display name, avatar, and user ID.
Privacy & Control
Only users you have blocked are shown. Inactive or deleted users are excluded.
You can only view users you have blocked—not users who have blocked you. Blocked users that are inactive or deleted will not appear in your list.
Product Behavior
- The blocked users list displays:
- User ID
- Display Name
- Avatar
- Other relevant user information
- Only active users you have blocked are shown
- You cannot see users who have blocked you
Get Blocked Users List (Paginated)
Retrieve and manage your blocked users list with pagination. This returns a live collection that automatically reflects changes when you block or unblock users.How It Works
- Live collection — Results are returned as a live collection
- Paginated — Results are loaded in pages. Use the platform’s pagination mechanism to load additional pages on demand.
Parameters
| Parameter | Type | Required | Description |
|---|---|---|---|
limit | Number | No | Number of users per page (default varies by platform, typically 20–25) |
Usage
Get All Blocked Users (Non-Paginated)
Platform Availability:
getAllBlockedUsers() is currently available on iOS and Android only. Web (TypeScript) support is under development.How It Works
- One-shot result — Returns the full blocked users list as a single async response, not a live collection.
- Built-in caching — The SDK caches the result for 5 minutes. The first call fetches from the server; subsequent calls within the TTL window resolve instantly from the local cache.
- Cache refresh — After 5 minutes, the next call triggers a fresh server fetch.
- Local changes — If you block or unblock a user between calls, the local cache is updated immediately. The next
getAllBlockedUsers()call reflects the change even without a server fetch. - Session-aware — The cache resets on logout. After re-login, the next call fetches fresh data.
Usage
- iOS
- Android
Use Case: Feed Filtering
A common use case is filtering out blocked users’ posts from a feed:- iOS
- Android
Limitations
- Hard limit of 100 users — Returns a maximum of 100 blocked users. If a user has more than 100 blocked users, only the most recent 100 are returned.
- Not a live collection — The result is a one-shot snapshot. It does not automatically update when block/unblock actions occur. Call the function again to get the latest list.
- Error propagation — If the server fetch fails (e.g., network error), the error is propagated to the caller. The SDK does not return a stale cached list on failure.
For real-time, paginated block lists (e.g., a “Manage Blocked Users” screen), use the existing
getBlockedUsers() live collection API above instead.Best Practices
User Experience
User Experience
- Provide clear UI for managing blocked users
- Allow easy unblocking from the list
- Show avatars and display names for quick identification
Performance & Pagination
Performance & Pagination
- Use pagination for large block lists
- Update the list in real-time as users are blocked/unblocked