--- source_url: https://www.pubnub.com/docs/pubnub-insights/basics title: PubNub Insights updated_at: 2026-06-04T11:10:44.048Z --- > Documentation Index > For a curated overview of PubNub documentation, see: https://www.pubnub.com/docs/llms.txt > For the full list of all documentation pages, see: https://www.pubnub.com/docs/llms-full.txt # PubNub Insights PubNub Insights gives you turnkey aggregated metrics and actionable analytics built from your PubNub data and usage. You can proactively adjust plans based on clear evidence. ## Availability PubNub Insights is automatically available to PubNub customers on the [Starter and Pro plans](https://www.pubnub.com/pricing/). * Starter - Access to Insights Premium dashboards. View analytics from 90 days up to three years. Includes user behavior analytics and features such as Analyze with AI, API access, and Expanded Data Download. See account-level, app-level, and selected keyset data. * Pro - Existing customers get Insights Standard dashboards with an option to upgrade to Insights Premium. Insights Standard includes analytics for the last 24 hours, today, and yesterday for the selected keyset. New customers get Insights Premium automatically. ## Access To get started, open the [Admin Portal](https://admin.pubnub.com/#/insights). After you sign in, select **Insights** from the sidebar. :::tip Public Admin Portal demo Want to browse through the Admin Portal without creating an account? Explore it through the [Public Demo](https://demo-admin.pubnub.com/) that shows examples of most PubNub features for transport and logistics use case. ::: If you use Insights Premium, select one or more use cases the first time you open Insights. After you select your use cases, the Account dashboard loads automatically. If you use Insights Standard, select the app, keyset, and use cases the first time you open Insights so the Snapshot dashboard loads automatically. To upgrade to **Insights Premium**, select **Upgrade**. ##### Use case selection **Use case** refers to how you currently use or plan to use PubNub in your application. If you use PubNub to build a chat app or an IoT app, select Chat or IoT from the use case dropdown on the PubNub Insights page in the Admin Portal. If you select Chat as a use case and follow PubNub’s payload convention, the Messages dashboard shows chat metrics automatically. You can select one or more use cases and update them at any time in Insights Dashboard Settings. ## Settings Insights automatically provides a set of five dashboards for each keyset. You can give each set a meaningful name and description. By default, each set inherits the name of its keyset. The Account and App dashboards have default names that can't be modified. The User Behavior & Devices and Account & App dashboards aren't available in Insights Standard. ### Dashboard info **Dashboard Info** lets you update or edit the **Use Case** for a keyset. By default, the use case you selected the first time you opened Insights is assigned to all keysets on your account. If a keyset needs a different use case, change it in **Dashboard Settings**. ### Messages **Messages Configuration** lets you change the data behind the analytics in your Messages dashboard. If “In-app Chat” is one of your selected use cases and you use the default PubNub messages JSON (JavaScript Object Notation) schema, then the Messages dashboard automatically shows the following two metrics: * Top 10 Message Types * Count of Message Type that is Chat If your implementation does not use the default PubNub JSON schema or you do not use PubNub for in‑app chat, the Messages dashboard shows empty charts. You can populate these charts by providing the JSON path for the two metrics above or for other items you want to track. ###### Align message payloads with Insights tracking Insights automatically tracks message types when your payloads follow PubNub's [message type conventions](https://www.pubnub.com/docs/general/messages/type). Assign a `custom_message_type` to each [published message](https://www.pubnub.com/docs/general/messages/publish) so the Messages dashboard can categorize traffic without additional configuration. If your payload structure differs, provide a custom JSON path in Messages Configuration to map your schema to Insights metrics. ## Terms in this document * **Dashboard** - A collection of widgets (charts) that give an overview of the metrics one is evaluating. * **PubNub** - PubNub is a real-time messaging platform that provides APIs and SDKs for building scalable applications. It handles the complex infrastructure of real-time communication, including: Message delivery and persistence, Presence detection, Access control, Push notifications, File sharing, Serverless processing with Functions and Events & Actions, Analytics and monitoring with BizOps Workspace, AI-powered insights with Illuminate.