> ## Documentation Index
> Fetch the complete documentation index at: https://gleanfeed.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Troubleshooting

> Common issues installing and running the Glean Feed iOS SDK.

## Views open signed-out after `identify`

The identity exchange did not complete. Check that:

* The **signature** is generated on your backend over the same `userId`/`email` you pass to `identify` (emails are trimmed and lowercased before signing — see [Identity](/ios-sdk/identity)).
* You passed the correct **workspace ID** to `setup` (from **Settings → Connections → iOS SDK**).
* Portal accounts are enabled for your workspace.

`identify` throws a typed `GleanFeedError` — log it in debug to see which case fired.

## Unread count is always `0`

`unreadCount()` is signed-in only. It returns `0` for anonymous customers and for a stale identity. Make sure `identify` succeeded first.

## The portal does not use the compact app layout

Update to the latest SDK version. The SDK tags its WebView so the portal renders its compact embed shell; older builds showed the standalone site.

## Diagnostics don't show up

`sendDiagnostics()` only sends with stored signed identity. The server keeps valid `platform`, `appVersion`, `osVersion`, and `sdkVersion` values plus the metadata key count. See [Diagnostics and privacy](/ios-sdk/diagnostics).

## A build error mentions the widget secret

The SDK has no signing helper and never needs your widget secret. If you're reaching for it in the app, move signing to your backend — see [Identity](/ios-sdk/identity).

## Still stuck?

* Confirm your identifiers on **Settings → Connections → iOS SDK**.
* Try an anonymous open first (`GleanFeed.showFeedback()` without `identify`) to isolate identity issues from setup issues.