Help
Troubleshooting
Cannot find package @iconical/presencekit?
Install in the directory with your application's package.json:
bun add @iconical/presencekitImport from the correct paths: @iconical/presencekit, /react, /react-ui, /vue, or /svelte. Use the full package name in every import.
404, missing user, or no result?
Only opted-in users are available. Confirm the Discord user ID (17–20 digits), ask the user to use /confirm in the official Discord community, and handle removal of consent via /disconnect. Do not render cached data when a request reports revocation.
availability: "pending" and presence: null?
The account is approved but there isn't a current snapshot yet. Render a pending state and wait for updates; don't assume data.presence.status always exists.
EventSource is not available?
The runtime lacks browser SSE support and transport: "sse" was requested. Use transport: "auto" for automatic fallback or transport: "poll" for polling only.
const stop = createPresenceClient().subscribePresence(id, observer, {
transport: "poll", intervalMs: 15_000,
});Image doesn't load?
Custom block: ActivityArtwork No renderer found yet for this block.getActivityArtwork() selects URLs, not a successful image request. In React prefer ; it tries another URL and falls back to initials. Some activities have no available artwork.
Next.js complains about client hooks?
Place "use client" at the top of the component using usePresence or live UI. ActivityArtwork renders a standard img, so you don't need to configure next/image remote image hosts for that SDK component.
I only see one activity?
data.presence.activities is an array. Iterate over it to show every reported activity. getPlayingActivities specifically selects Playing activities, while getSpotifyActivity and getCustomStatus select different types.
Too many streams or lingering requests?
Call the function returned by subscribePresence/subscribePresences when you're done. In React/Vue/Svelte prefer framework integration that automatically unsubscribes. For a roster, use usePresences or the shared manager.
Still stuck?
Read the API reference and report an issue at himinthevoid/presencekit, with your package version, framework, error text, and a minimal reproduction. Never post credentials.
Was this page helpful?