Prerequisites
- The OneSignal SDK is installed in your mobile app or website. See Mobile SDK setup or Web push setup.
- Your users have push subscriptions.
What the chart shows
A session begins each time a user opens your app or website from a fully closed state, or reopens it after being in the background for at least 30 seconds. Returning within 30 seconds continues the current session instead of starting a new one. The chart shows one bar per day for the window you pick. The Total sessions and Avg duration cards summarize that window, and both update when you change the window.
OneSignal began collecting session data on September 30, 2026. If your window reaches back before that date, a Data collection starts line marks the first day, and the cards count only sessions from that day on.
How sessions are counted
- Every session counts. Sessions volume counts every session, whether or not it is attributed to a message. To see which sessions are attributed to your messages, use App Sessions in Conversion metrics.
- Each session counts on the day it started. Days are UTC calendar days. A session that starts before midnight UTC and ends after it counts on the first day.
- Durations follow the session event rules. Very long durations and out-of-range times are adjusted the same way as on the profile. See How OneSignal records session events.
Choose a window
Use the window dropdown above the chart to pick 7 days, 14 days, 30 days, 60 days, or 90 days. The chart opens on the longest window your plan allows, up to 30 days. Windows longer than your plan’s session event retention show a lock icon. Select a locked window to see Upgrade to measure sessions over a longer window. and your upgrade options. OneSignal records session events for every app on every plan. Your plan sets how far back you can view them.
When you upgrade, you can view further back right away, up to your new plan’s limit.
FAQ
How is Sessions volume different from App Sessions in Conversion metrics?
Sessions volume shows how many sessions happened in your app. App Sessions in Conversion metrics shows how those sessions relate to your messages, split into Direct, Influenced, and Unattributed. Use Sessions volume to see overall activity, and Conversion metrics to see which sessions are attributed to your messages.Why does the chart say “No sessions yet”?
Your app has not reported any sessions yet. Sessions appear once the OneSignal SDK is installed and users with push subscriptions open your app or website.Why does the chart say “No sessions in this window”?
Nobody opened your app during the selected window. Choose a longer window to look further back.Why can’t I select a longer window?
Your plan’s session event retention is shorter than that window. See Choose a window for each plan’s limit.Why does a session appear on a different day than on the user’s profile?
Sessions volume groups sessions by the UTC day they started. The session list on a user’s profile shows times in your browser’s timezone. A session near midnight can fall on a different day in each view.Related pages
Session events
See every session a user or subscription had, with start time, end time, and duration.
Retention metrics
Measure whether users come back on the days after they were active.
Sessions
How OneSignal defines and counts a session.
Conversion metrics
See which sessions and conversions are attributed to your messages.