9.1 User Issues
| Problem | Try this |
|---|---|
| No people shown | Refresh the page; confirm access to the host SharePoint site |
| Missing photos | Some users may not have profile photos — initials are shown instead |
| Presence not updating | Presence refreshes periodically; click Refresh |
| Filters return no results | Clear filters and try a broader search |
| Org chart won't expand | The person may have no direct reports in Microsoft 365 |
| Can't see Dashboard | Request management access from your administrator |
9.2 Administrator Issues
- Web part not in toolbox — Re-upload .sppkg, deploy tenant-wide, or install app on the site manually.
- Graph consent errors — Approve pending API access requests in SharePoint Admin Center.
- Mock data showing — Turn off Use sample data in the property pane and publish.
- Teams tab error — Verify host SharePoint page is published and user has site read access.
- Subscription lock screen — Confirm subscription API URL, trial status, and Stripe webhook health.
9.3 Support Checklist
- App catalog deploy and Graph consent approved.
- Use sample data is off.
- User has read access to the host site (Teams).
- Subscription API reachable if billing enabled.
- User is not in exclusion lists.
- Check browser console (F12) for Graph or CORS errors.
Additional App Functionality
Subscription Troubleshooting
- Verify API health at /health on the subscription service.
- Confirm people-hub has a Stripe price in the product catalog.
- Check CORS (APP_ORIGIN) and Stripe Dashboard logs if checkout fails.
- Use Activate license for enterprise keys issued from the subscription API admin console.