# OneSignal: English User Guides

> OneSignal is a platform for sending push notifications, emails, in-app messages, and SMS campaigns via a single API, Journey Builder, and a dashboard.

## User Guides

### First steps & settings

- [Getting started with OneSignal](https://documentation.onesignal.com/docs/en/quickstart-guide.md): Set up your OneSignal account, configure push, in-app messages, email, and SMS/RCS, organize Users with tags and segments, and send your first message or Journey.
- [Migrating to OneSignal](https://documentation.onesignal.com/docs/en/migrating-to-onesignal.md): Migrate to OneSignal from another messaging provider with SDK integration, user import, phased rollout, and testing guidance.

#### OneSignal dashboard

- [Apps, Organizations, & Accounts](https://documentation.onesignal.com/docs/en/apps-organizations.md): Add, rename, move, and delete OneSignal apps and organizations. Understand the relationship between accounts, apps, and organizations.
- [Team members](https://documentation.onesignal.com/docs/en/manage-team-members.md): Manage OneSignal user access by adding, removing, or updating team member roles at the app or organization level. Learn role permissions and plan availability.
- [Keys & IDs](https://documentation.onesignal.com/docs/en/keys-and-ids.md): Find and manage your OneSignal App ID, Organization ID, and API keys. Learn how to create, rotate, secure, and migrate keys safely.
- [Audit Logs](https://documentation.onesignal.com/docs/en/audit-logs.md): Track and review user activity across your OneSignal organization for security, compliance, and accountability. Export to JSONL or query via the REST API.
- [Usage & billing](https://documentation.onesignal.com/docs/en/billing-faq.md): Answers to OneSignal billing questions: how MAU is counted, Free plan limits, invoice charges, payment methods, and ways to reduce usage costs.
- [Disabled apps & organizations](https://documentation.onesignal.com/docs/en/disabled-apps.md): Reasons OneSignal disables Apps and Organizations, what disablement blocks, and how App Admins and Organization Admins can restore access.

### Message channels

- [Channel setup](https://documentation.onesignal.com/docs/en/channel-setup.md): Set up push notifications, in-app messages, email, SMS, RCS, and Live Activities in OneSignal to reach Users across every channel.

#### Push

- [Push overview](https://documentation.onesignal.com/docs/en/push.md): Send and manage mobile and web push notifications with OneSignal using the dashboard or API, with targeting, personalization, and scheduling.

##### Mobile push

- [Mobile push setup](https://documentation.onesignal.com/docs/en/mobile-push-setup.md): End-to-end checklist for setting up mobile push notifications with OneSignal on iOS, Android, Huawei, and Amazon, from SDK setup to permission prompts.
- [Prompt for push permissions](https://documentation.onesignal.com/docs/en/prompt-for-push-permissions.md): Increase push notification opt-in rates on iOS, Android, and Huawei with strategic timing, in-app soft prompts, and iOS provisional notifications.
- [iOS provisional push notifications](https://documentation.onesignal.com/docs/en/ios-provisional-push-notifications.md): Provisional push notifications on iOS let your app send notifications without an upfront permission prompt, but with reduced visibility.
- [Android notification categories](https://documentation.onesignal.com/docs/en/android-notification-categories.md): Create Android notification categories (channels) in OneSignal to control sound, importance, and lock screen visibility per notification type.
- [Data & background notifications](https://documentation.onesignal.com/docs/en/data-notifications.md): Send silent push notifications to sync data or trigger background tasks on iOS and Android without displaying a visible message.
- [VoIP push notifications](https://documentation.onesignal.com/docs/en/voip-notifications.md): Send VoIP push notifications on iOS using OneSignal with PushKit token registration and a VoIP certificate, plus Android alternatives for call-style behavior.

##### Web push

- [Web push setup](https://documentation.onesignal.com/docs/en/web-push-setup.md): Set up web push notifications with OneSignal to re-engage users on Chrome, Firefox, Safari, and Edge. Configure your site, prompts, and service worker.
- [Web permission prompts](https://documentation.onesignal.com/docs/en/permission-requests.md): Configure OneSignal web push permission prompts to maximize opt-ins, including slidedown soft prompts, the native browser prompt, and subscription bell.
- [Web push FAQ](https://documentation.onesignal.com/docs/en/web-push-setup-faq.md): Complete guide to OneSignal Web Push Notifications setup, requirements, browser compatibility, domain changes, and troubleshooting common issues for developers and website owners.
- [Web push browser behavior](https://documentation.onesignal.com/docs/en/browser-behavior-and-unsubscribes.md): Learn how to unsubscribe from notifications and understand how browsers handle web push subscriptions.
- [OneSignal WordPress plugin setup for web push](https://documentation.onesignal.com/docs/en/wordpress.md): Install and configure the OneSignal WordPress plugin v3+ for web push notifications, including setup steps and migration from the legacy 2.x plugin.
- [WordPress troubleshooting](https://documentation.onesignal.com/docs/en/troubleshooting-wordpress-web-push.md): Troubleshoot OneSignal web push on WordPress, including plugin setup issues, browser compatibility, and CDN or caching plugin conflicts.
- [Shopify web push integration](https://documentation.onesignal.com/docs/en/shopify.md): Connect Shopify to OneSignal through the Vendo integration for web push notifications, customer tags, commerce events, and behavioral targeting.

##### Push features

- [Notification icons](https://documentation.onesignal.com/docs/en/notification-icons.md): Choose default and per-message push notification icons on Android, iOS, and Web, including sizes and the transparency rule that prevents a white square.
- [Notification images & rich media](https://documentation.onesignal.com/docs/en/rich-media.md): Add images, GIFs, and rich media to mobile push notifications with OneSignal's Dashboard and API, including image formats and device-specific behavior.
- [Notification sounds](https://documentation.onesignal.com/docs/en/notification-sounds.md): Add custom notification sounds to iOS, Android, Huawei, and Amazon apps — including file formats, SDK setup, and API parameters.
- [Notification badges](https://documentation.onesignal.com/docs/en/badges.md): Manage app icon badge counts for push notifications on iOS, Android, and Huawei, including auto-clearing, API control, and native badge logic.
- [Action buttons for push notifications](https://documentation.onesignal.com/docs/en/action-buttons.md): Add interactive action buttons to your push notifications on iOS, Android, and the web. Learn setup via Dashboard & API, supported platforms, click handling, icons, and event tracking.
- [Push frequency capping](https://documentation.onesignal.com/docs/en/frequency-capping.md): Push frequency capping limits how many push notifications a single user can receive in a rolling minute, hour, day, or week window — useful when multiple teams, Journeys, or automated triggers risk over-messaging the same user.
- [Push throttling](https://documentation.onesignal.com/docs/en/throttling.md): Push throttling controls how fast OneSignal delivers push notifications, helping you manage server load and avoid performance issues during high-volume sends.
- [iOS: Focus modes and interruption levels](https://documentation.onesignal.com/docs/en/ios-focus-modes-and-interruption-levels.md): How iOS Focus modes and the four interruption levels affect push delivery, and how to set them in OneSignal — including critical alerts entitlement setup.
- [iOS: Relevance score](https://documentation.onesignal.com/docs/en/ios-relevance-score.md): Set Apple's relevance score to control how prominently a push appears in the iOS Notification Summary, or a Live Activity on the Lock Screen.

##### Push analytics & troubleshooting

- [Push message reports](https://documentation.onesignal.com/docs/en/push-notification-message-reports.md): Push message reports show delivery outcomes, confirmed receipt, failure diagnostics, click-through rates, and per-Subscription audience activity for each push send.
- [Confirmed receipt](https://documentation.onesignal.com/docs/en/confirmed-delivery.md): Confirmed receipt tracks when a device receives a push sent through OneSignal. Covers paid-plan requirements, platform limitations, and troubleshooting for iOS, Android, Huawei, Web, and Live Activities.
- [Notification click-through rate (CTR)](https://documentation.onesignal.com/docs/en/notification-ctr.md): Troubleshoot and improve push notification click-through rate (CTR) in OneSignal. Covers how CTR is calculated, common causes of drops, reporting methodology, and tactics to improve engagement.
- [Mobile push: Notifications not shown or delayed](https://documentation.onesignal.com/docs/en/notifications-show-successful-but-are-not-being-shown.md): Troubleshoot mobile push notifications that show as Delivered in OneSignal but don't appear or are delayed on Android and iOS devices.
- [Web push: Notifications not shown](https://documentation.onesignal.com/docs/en/notifications-not-shown-web-push.md): Troubleshoot web push notifications that show as Delivered in OneSignal but don't appear on a subscriber's device.
- [Notification Images Not Showing](https://documentation.onesignal.com/docs/en/notification-images-not-showing.md): Notifications images not appearing.
- [Duplicated notifications](https://documentation.onesignal.com/docs/en/duplicated-notifications.md): Troubleshoot duplicate push notifications caused by SDK conflicts, server-side retries, multi-app environments, and platform-specific bugs.
- [FCM expired token FAQ](https://documentation.onesignal.com/docs/en/fcm-expired-token-faq.md): Why Android and Chrome push subscriptions get unsubscribed due to FCM token expiry, Google spam suppression, and how to troubleshoot unsubscribe spikes.

#### In-app messages

- [In-app overview](https://documentation.onesignal.com/docs/en/in-app-messages-setup.md): Display targeted, customizable messages inside your mobile app to drive engagement, collect feedback, and prompt actions like push opt-in.
- [In-app triggers](https://documentation.onesignal.com/docs/en/iam-triggers.md): Options for displaying in-app messages to users.
- [In-app click actions](https://documentation.onesignal.com/docs/en/iam-click-actions.md): Configure click actions on in-app message elements to open URLs, prompt for push or location permissions, track outcomes, tag users, or trigger custom logic.
- [In-app message reports](https://documentation.onesignal.com/docs/en/in-app-message-reports.md): OneSignal In-App Message delivery and statistics
- [In-app troubleshooting](https://documentation.onesignal.com/docs/en/in-app-message-troubleshooting.md): Common questions and troubleshooting steps about in-app messages.

##### In-app design

- [Design in-app messages with drag-and-drop](https://documentation.onesignal.com/docs/en/design-your-in-app-message.md): Use OneSignal's visual composer to build high-converting in-app messages with blocks, layouts, carousels, and personalization.
- [Design in-app messages with HTML](https://documentation.onesignal.com/docs/en/design-your-in-app-message-with-html.md): Design and customize in‑app messages using OneSignal's HTML Editor for maximum flexibility, responsiveness, and branding.
- [In-app message templates & quickstarts](https://documentation.onesignal.com/docs/en/in-app-html-templates.md): OneSignal quickstart designs and copy/paste HTML templates for In-App Messages, plus required setup and common gotchas.
- [In-app message JavaScript API reference](https://documentation.onesignal.com/docs/en/in-app-message-api.md): JavaScript methods for interactive HTML in-app messages in OneSignal.

#### Email

- [Email overview](https://documentation.onesignal.com/docs/en/email-messaging.md): Send marketing and transactional emails with OneSignal using the dashboard, Journeys, or the API, with built-in personalization, analytics, and deliverability tools.

##### Email setup

- [Email setup](https://documentation.onesignal.com/docs/en/email-setup.md): Set up OneSignal Email by selecting a provider, creating a sender, configuring DNS authentication, and verifying your account.
- [Email DNS configuration](https://documentation.onesignal.com/docs/en/email-dns-configuration.md): Manually add SPF, DKIM, DMARC, CNAME, and MX DNS records to authenticate your email sending domain and improve deliverability with OneSignal.
- [Senders](https://documentation.onesignal.com/docs/en/senders.md): Learn how to manage sender identities and domains to improve email deliverability and maintain a strong sender reputation.
- [BCC emails](https://documentation.onesignal.com/docs/en/email-bcc.md): Send a hidden copy of an outgoing email to additional recipients for archiving, compliance, or third-party integrations.
- [Transactional emails](https://documentation.onesignal.com/docs/en/setup-transactional-emails.md): Send transactional emails like purchase confirmations, password resets, and welcome messages through OneSignal with delivery, click, and open tracking.
- [Create a custom email unsubscribe page](https://documentation.onesignal.com/docs/en/create-custom-unsubscribe-page.md): Learn how to replace OneSignal's default unsubscribe link with a branded, multi-language, and personalized email preferences page, while maintaining compliance and tracking.

##### Email deliverability & analytics

- [Email message reports](https://documentation.onesignal.com/docs/en/email-message-reports.md): Track email delivery, opens, clicks, bounces, suppressions, and spam reports in OneSignal email message reports.
- [Email deliverability](https://documentation.onesignal.com/docs/en/email-deliverability.md): Improve inbox placement by managing sender reputation, reducing bounces and spam complaints, and following email hygiene best practices.
- [Deliverability insights by inbox provider](https://documentation.onesignal.com/docs/en/email-deliverability-insights.md): See email delivery, opens, clicks, bounces, failures, and spam complaints broken down by inbox provider (Gmail, Outlook, Yahoo, Apple, and more) to pinpoint where deliverability problems are coming from.
- [Email reputation best practices](https://documentation.onesignal.com/docs/en/email-reputation-best-practices.md): Build and maintain a healthy email sending reputation to improve deliverability and avoid spam complaints.
- [Email address validation](https://documentation.onesignal.com/docs/en/email-address-validation.md): Validate email addresses during CSV import and in bulk to reduce bounces and protect your sender reputation.
- [Email warm-up](https://documentation.onesignal.com/docs/en/email-warm-up.md): Build sender reputation with inbox providers by gradually scaling email volume to your most engaged recipients. Covers warm-up triggers, ramp schedule, Auto Warm Up, and FAQ.
- [Google Postmaster Tools](https://documentation.onesignal.com/docs/en/google-postmaster-tools.md): Set up Google Postmaster Tools to monitor Gmail spam rates and domain reputation. Gmail does not share this data directly with email senders.
- [Suppressions](https://documentation.onesignal.com/docs/en/suppressions.md): Manage suppressed email addresses in OneSignal to maintain list hygiene, reduce bounces, and protect your sender reputation.
- [Email troubleshooting](https://documentation.onesignal.com/docs/en/email-troubleshooting.md): How to diagnose and fix common OneSignal email issues.

##### Design your emails

- [Design emails with drag-and-drop](https://documentation.onesignal.com/docs/en/design-emails-with-drag-and-drop.md): Build responsive emails visually with OneSignal’s Drag and Drop Email Builder — settings, rows, content blocks, personalization, and compliance links.
- [Design emails with HTML](https://documentation.onesignal.com/docs/en/design-emails-with-html.md): Send fully custom branded emails using OneSignal's HTML Editor. Covers supported HTML rules, inline CSS, dark mode, unsubscribe handling, and client limitations.
- [Email unsubscribe links & headers](https://documentation.onesignal.com/docs/en/unsubscribe-links-email-subscriptions.md): Learn how to manage email unsubscribe behavior in OneSignal, including unsubscribe links, List-Unsubscribe headers, suppression rules, and resubscription workflows.
- [Email template forwarding](https://documentation.onesignal.com/docs/en/email-template-forwarding.md): Forward your email templates to create them quickly!

#### SMS & RCS

- [SMS, MMS, and RCS overview](https://documentation.onesignal.com/docs/en/sms-messaging.md): Send text messages with OneSignal. Covers SMS, MMS, and RCS formats, the three texting program types (promotional, transactional, OTP), and setup paths for each use case.
- [Rich Communication Services (RCS)](https://documentation.onesignal.com/docs/en/rcs-messaging.md): Send branded, app-like messages with RCS in OneSignal. Covers rich content types, sender setup, image requirements, SMS fallback, and country availability.

##### SMS setup

- [SMS setup](https://documentation.onesignal.com/docs/en/sms-setup.md): Set up texting with OneSignal. Understand the brand, sender, and sender resource model, choose between OneSignal SMS and Twilio, and learn how to migrate from an existing provider.
- [Sender resource applications and country requirements](https://documentation.onesignal.com/docs/en/sms-registration-requirements.md): Apply for SMS and RCS sender resources by country. Covers brand and campaign approval processes, standard application requirements, sender resource type traits, and per-country approval tables for all supported geographies.
- [SMS opt-in and collection](https://documentation.onesignal.com/docs/en/sms-opt-in-and-collection.md): Collect valid SMS consent for promotional, transactional, and OTP programs. Covers opt-in collection methods, disclosure requirements, audience validation, and phone number format requirements.
- [SMS consent keyword management](https://documentation.onesignal.com/docs/en/sms-consent-keyword-management.md): Manage SMS opt-out keywords, resubscribe flows, and auto-responders. Covers STOP/HELP/START behavior, web-based unsubscribe for alphanumeric senders, shared sender opt-out strategies, and viewing subscriber consent status.
- [SMS keywords](https://documentation.onesignal.com/docs/en/keywords.md): Use SMS keywords in OneSignal for two-way engagement campaigns, preference centers, and audience segmentation. Covers keyword setup, reply templates, data tags, and measuring keyword engagement.

##### SMS messaging

- [Promotional messaging](https://documentation.onesignal.com/docs/en/sms-promotional-messaging.md): Send SMS and MMS promotional campaigns with OneSignal. Covers double opt-in setup, preference centers, sender strategy, and sending via Dashboard, Journeys, or API.
- [Transactional messaging](https://documentation.onesignal.com/docs/en/sms-transactional-messaging.md): Send transactional SMS and MMS messages with OneSignal. Covers use cases, opt-in collection, compliance requirements, and sending via Journeys or API.
- [One-time passwords (OTP)](https://documentation.onesignal.com/docs/en/sms-verify.md): Send one-time password messages with OneSignal for two-factor authentication, account verification, and fraud prevention. Covers OneSignal Verify, DIY code authentication, dedicated sender best practices, and audience validation.
- [Composing messages](https://documentation.onesignal.com/docs/en/sms-composing-messages.md): Compose SMS, MMS, and RCS messages in OneSignal. Covers the SMS and RCS editors, character limits and encoding, message segments, trackable links, personalization, and how content affects billing.
- [SMS message reports](https://documentation.onesignal.com/docs/en/sms-message-reports.md): View SMS and RCS delivery statistics, click-through rates, and failure details in OneSignal. Covers all message metrics, error code troubleshooting, data retention, and how to export data.

#### Live Activities

- [Live Activities](https://documentation.onesignal.com/docs/en/live-activities.md): Show real-time updates on the iOS Lock Screen and Dynamic Island for deliveries, rides, and live scores, with setup, targeting, and analytics.
- [Live Activities analytics](https://documentation.onesignal.com/docs/en/live-activities-analytics.md): Measure delivery, confirmed receipt, clicks, and unsubscribes for iOS Live Activities with OneSignal. Covers key metrics, individual message reports, Audience Activity, and CSV export.

#### Features

- [A/B Testing](https://documentation.onesignal.com/docs/en/ab-testing.md): Optimize your push and email messaging with OneSignal's A/B testing to improve engagement and campaign performance.
- [Multi-language messaging](https://documentation.onesignal.com/docs/en/multi-language-messaging.md): Send push, email, in-app, and SMS in each user's language. Set the language property, then match it from the dashboard or the Create message API.
- [Brand Kit](https://documentation.onesignal.com/docs/en/brand-kit.md): Set up Brand Kit in OneSignal to keep AI-generated content on-brand and make your logos, colors, and fonts available across all channel editors without re-uploading.
- [Retargeting messages](https://documentation.onesignal.com/docs/en/retargeting.md): Send follow-up push messages in OneSignal based on how Subscriptions interacted with a previous send — clicked, didn't click, failed delivery, or unsubscribed. Retargeting is available from any push message report within 30 days of the original send.
- [Templates](https://documentation.onesignal.com/docs/en/templates.md): Create, send, and track reusable templates for push notifications, email, and SMS in OneSignal with Liquid personalization and aggregate performance metrics.
- [Labels](https://documentation.onesignal.com/docs/en/labels.md): Organize and manage messages across push, email, SMS, and in-app channels with Labels in OneSignal. Easily filter, categorize, and streamline your campaign workflow.

##### Personalization

- [Personalization](https://documentation.onesignal.com/docs/en/message-personalization.md): Compare OneSignal personalization methods, including Properties, Custom Events, API custom_data, Data Feeds, and CSV uploads with Liquid syntax.
- [Using Liquid syntax](https://documentation.onesignal.com/docs/en/using-liquid-syntax.md): Personalize email, push, SMS, in-app, and Live Activity content with Liquid tags, filters, conditionals, and loops — powered by OneSignal data sources like tags, properties, custom data, and Data Feeds.
- [Data feeds](https://documentation.onesignal.com/docs/en/data-feeds.md): Pull real-time data from your APIs into OneSignal email and SMS messages at send time using Data Feeds, with Liquid syntax for personalization.
- [Personalize with Custom Events](https://documentation.onesignal.com/docs/en/personalization-custom-event.md): Use Custom Event properties to personalize Journey messages with Liquid syntax. Learn how events are stored, accessed, and rendered in push, email, and SMS templates.
- [Personalize with properties](https://documentation.onesignal.com/docs/en/personalization-properties-and-tags.md): Personalize OneSignal messages using predefined properties and custom Tags. Access user, subscription, journey, message, template, and app-level data with Liquid syntax across email, push, SMS, and webhooks.
- [Personalize messages with API custom_data](https://documentation.onesignal.com/docs/en/personalization-api-custom-data.md): Send dynamic, message-specific data through the Create Message API using custom_data. Reference values in templates with Liquid syntax for real-time personalization.
- [Dynamic Content with CSV](https://documentation.onesignal.com/docs/en/dynamic-content.md): Personalize push, email, and SMS messages at scale using Dynamic Content with CSV uploads and Liquid syntax in OneSignal.

##### URLs, Links, & Deep Links

- [URLs, links, & deep links](https://documentation.onesignal.com/docs/en/links.md): Set up launch URLs, deep links, dynamic URLs, UTM tracking, and click tracking across push notifications, email, in-app, SMS, and RCS messages.
- [Deep linking](https://documentation.onesignal.com/docs/en/deep-linking.md): Send users from OneSignal push, in-app, email, and SMS messages to a specific screen in your Android or iOS app using Universal Links, App Links, or custom URI schemes.
- [Email unsubscribe links & headers](https://documentation.onesignal.com/docs/en/unsubscribe-links-email-subscriptions.md): Learn how to manage email unsubscribe behavior in OneSignal, including unsubscribe links, List-Unsubscribe headers, suppression rules, and resubscription workflows.

### Journeys

- [Journeys overview](https://documentation.onesignal.com/docs/en/journeys-overview.md): Automated multichannel messaging flows that send email, push, SMS, and in-app messages based on user behavior, time delays, or profile attributes.
- [Journey examples](https://documentation.onesignal.com/docs/en/journeys-examples.md): Step-by-step Journey configurations for onboarding, re-engagement, abandoned cart, A/B testing, recurring sends, and event-driven workflows.
- [Control Journey membership with tags](https://documentation.onesignal.com/docs/en/journeys-membership-tags.md): Use Tag User steps and segments to control which users enter a Journey: keep A/B/C variants mutually exclusive, or send a percentage of one Journey's users into another.

#### Journey features

- [Journey settings](https://documentation.onesignal.com/docs/en/journeys-settings.md): Configure your Journey including who enters, exits, re-enters, and when it starts or stops.
- [Journey messages](https://documentation.onesignal.com/docs/en/journeys-messages.md): Configure push notification, email, SMS, and in-app message steps in a Journey, including templates, delivery timing, and session requirements.
- [Journey message A/B testing](https://documentation.onesignal.com/docs/en/journeys-ab-testing.md): Run A/B tests on push, email, and SMS message steps in a Journey, compare variants on a target metric, and select a winner automatically or manually.
- [Journey actions](https://documentation.onesignal.com/docs/en/journeys-actions.md): Define wait periods, branch journeys based on user behavior, and tag users using journey steps.
- [Journey webhooks](https://documentation.onesignal.com/docs/en/journeys-webhook.md): Send HTTP requests from Journey steps to external servers, personalized with user data via Liquid syntax, with retry logic and debugging tools.
- [Send WhatsApp Messages via Journey Webhooks](https://documentation.onesignal.com/docs/en/sending-whatsapp-messages-via-journey-webhooks.md): Send WhatsApp messages automatically using OneSignal Journeys and webhooks.
- [Managing journeys](https://documentation.onesignal.com/docs/en/managing-journeys.md): Edit Journey steps and messages, view stats, duplicate or archive flows, delete Journeys, and add team notes for collaboration.
- [Journey analytics](https://documentation.onesignal.com/docs/en/journeys-analytics.md): Track Journey performance with delivery metrics, user activity, and conversion insights across push, email, SMS, and in-app channels.

### OneSignal AI

- [OneSignal AI](https://documentation.onesignal.com/docs/en/onesignal-ai.md): OneSignal AI is the assistant built into the dashboard that answers questions, analyzes your performance, and drafts segments, messages, and journeys from your real account data.
- [OneSignal Home](https://documentation.onesignal.com/docs/en/onesignal-home.md): OneSignal Home is the AI-first landing experience in the dashboard. Chat with OneSignal AI, get setup guidance, and explore recommendations from a single page.
- [OneSignal MCP Server](https://documentation.onesignal.com/docs/en/model-context-protocol.md): Connect MCP-compatible AI clients to OneSignal so you can manage users, segments, templates, messaging, and exports with natural-language prompts.
- [OneSignal AI data practices](https://documentation.onesignal.com/docs/en/ai-data-practices.md): What data OneSignal AI uses, how long it is retained, the controls you have, and what OneSignal does and does not do with that data.
- [AI message composer](https://documentation.onesignal.com/docs/en/ai-message-composer.md): Use OneSignal's built in AI to write and adjust push notifications to suit your needs and send the right message quickly and easily

### Audience & events

- [Segments](https://documentation.onesignal.com/docs/en/segmentation.md): Create and manage dynamic user segments in OneSignal to target personalized messaging based on activity, location, tags, and more.
- [User-based segmentation](https://documentation.onesignal.com/docs/en/user-based-segmentation.md): User-based segments group Users with all of their Subscriptions, so one segment reaches every channel. Coming soon. Covers segment evaluation, optional Subscription filters for push and in-app messages, and user counts.
- [Import](https://documentation.onesignal.com/docs/en/import.md): Import or update users in OneSignal using CSV uploads, REST API, or manual entry. Supports email, SMS, tags, and more for seamless user onboarding or migration.

#### Users & Subscriptions

- [Users](https://documentation.onesignal.com/docs/en/users.md): How OneSignal Users, OneSignal IDs, and External IDs connect Subscriptions across channels and devices.
- [Subscriptions](https://documentation.onesignal.com/docs/en/subscriptions.md): Manage Subscriptions across mobile push, web push, email, and SMS in OneSignal. Covers properties, statuses, and how to update or migrate them.
- [Sessions](https://documentation.onesignal.com/docs/en/sessions.md): How OneSignal defines and counts app sessions, the session properties (First Session, Last Session, Session Count), per-user session events, and how sessions power segmentation, analytics, and billing.
- [User and Subscription Profiles](https://documentation.onesignal.com/docs/en/user-subscription-profiles.md): View and manage individual user records, subscriptions, tags, journeys, and message activity from the Audience section of the dashboard.
- [Aliases](https://documentation.onesignal.com/docs/en/aliases.md): Learn how to use custom aliases in OneSignal to identify and track users across different platforms and devices using your own unique identifiers. Aliases help unify user data across multiple sources and are essential for integrations, user data management, and transactional messaging.
- [Test users](https://documentation.onesignal.com/docs/en/test-users.md): Mark a User as a test user in OneSignal to validate message delivery, rendering, and Journey behavior across all of their Subscriptions before sending to production.
- [Delete users](https://documentation.onesignal.com/docs/en/delete-users.md): Delete users and subscriptions in OneSignal via the Dashboard or API for privacy compliance, cleanup, or bulk removal of inactive data.

#### Events

- [Message events](https://documentation.onesignal.com/docs/en/message-events.md): Track per-user message interactions: delivered, opened, clicked, and more.
- [Session events](https://documentation.onesignal.com/docs/en/session-events.md): View every session a user or subscription had in the OneSignal dashboard, with start time, end time, and duration. Use session events to see which users came back to your app.

##### Custom events

- [Custom events](https://documentation.onesignal.com/docs/en/custom-events.md): Track user behavior with Custom Events and use them to trigger Journeys, control flow with Wait Until steps, personalize messages in real time, measure conversions, and segment users.
- [Custom event best practices](https://documentation.onesignal.com/docs/en/custom-event-best-practices.md): Leverage your Custom Events in OneSignal: shape their properties so Journeys, Segments, and Conversion Metrics can use them, personalize messages with event properties, and see how one event can trigger, target, and measure at the same time.
- [Custom event storage and retention](https://documentation.onesignal.com/docs/en/custom-event-storage.md): Store Custom Events to build Segments and see event history on user profiles, choose a retention period per event, and manage stored events.

#### Tags

- [Tags](https://documentation.onesignal.com/docs/en/add-user-data-tags.md): Use OneSignal Tags to store user properties and track events for advanced segmentation and personalized messaging.
- [Tags: Time Operators](https://documentation.onesignal.com/docs/en/time-operators.md): Automate time-based messages using Time Elapsed operators with Tags that store Unix timestamps in seconds.

### Analytics & Integrations

#### Analytics

- [Analytics overview](https://documentation.onesignal.com/docs/en/analytics-overview.md): Measure message performance, user engagement, and conversions in OneSignal. Covers dashboards, attribution models, trends, and data export.
- [Metrics glossary](https://documentation.onesignal.com/docs/en/analytics-metrics-glossary.md): Map delivery and engagement metric names across the dashboard, View Message API, CSV exports, and Event Streams for push, email, SMS/RCS, in-app, and Live Activities.
- [Goals](https://documentation.onesignal.com/docs/en/goals.md): Define a success metric and target value on a Journey, using engagement or conversion metrics, then track progress on the Journey report.
- [Exporting data](https://documentation.onesignal.com/docs/en/exporting-data.md): Export message, subscription, and audience activity data from OneSignal using dashboard CSVs, REST API endpoints, and Event Streams.
- [Template analytics](https://documentation.onesignal.com/docs/en/template-analytics.md): Review delivery statistics, engagement metrics, and audience activity for push, email, and SMS templates in OneSignal.
- [Conversion metrics](https://documentation.onesignal.com/docs/en/conversion-metrics.md): Track the business impact of your messaging by attributing conversions like purchases and sign-ups to push, email, SMS, in-app, and RCS messages.
- [Engagement trends](https://documentation.onesignal.com/docs/en/engagement-analytics.md): Track user engagement across push, in-app, email, SMS, and Live Activities with the Engagement Trends chart in OneSignal. View delivery, click-through, and unsubscribe rates, and export to CSV.
- [Subscription trends](https://documentation.onesignal.com/docs/en/subscription-trends.md): Track how subscriptions grow and decline over time by channel in OneSignal. Monitors total subscribed count and opt-in and opt-out activity across push, email, SMS, and in-app channels.
- [Sessions volume](https://documentation.onesignal.com/docs/en/sessions-volume.md): Track how many sessions your app or website had each day, plus total sessions and average session duration, with the OneSignal Sessions volume chart.
- [Custom Outcomes](https://documentation.onesignal.com/docs/en/custom-outcomes.md): Learn how to track user actions and revenue from push notifications and in-app messages using OneSignal Custom Outcomes. Customize attribution and measure engagement with flexible outcome types across platforms.

##### Retention metrics

- [Retention metrics](https://documentation.onesignal.com/docs/en/retention-metrics.md): Track whether users return to your app or website with the OneSignal Retention chart. Build a cohort by date and measure retention over 7, 14, or 30 days.
- [Interpreting retention curves](https://documentation.onesignal.com/docs/en/interpreting-retention-curves.md): Read the OneSignal Retention curve after picking a cohort: what the shape means for return behavior, why the line can rise, and how channel series differ.

#### Event Streams

- [Event Streams](https://documentation.onesignal.com/docs/en/event-streams.md): Stream message events like sent, delivered, clicked, and bounced out of OneSignal to your servers, webhooks, and integrations in real time.
- [Event Stream data reference](https://documentation.onesignal.com/docs/en/event-streams-data.md): Schema reference for all event, message, user, and subscription properties available in Event Streams and Webhooks, with Liquid syntax for each field.
- [In-app message event streams](https://documentation.onesignal.com/docs/en/iam-event-streams.md): How to utilize event streams to capture in-app message metrics
- [Google Sheets integration with Event Streams](https://documentation.onesignal.com/docs/en/google-sheets-integration-with-event-streams.md): This guide illustrates the required steps to setup a connection between OneSignal’s Event Webhooks to a custom Google Sheets document to analyze message events generated by OneSignal.

#### Integrations

- [Integrations overview](https://documentation.onesignal.com/docs/en/integrations.md): Connect OneSignal to third-party platforms to sync audiences, custom events, and message data. Choose inbound, outbound, or bidirectional integrations by goal.
- [Data warehouse, DMP, & CRM integration](https://documentation.onesignal.com/docs/en/database-dmp-crm-integration.md): Integrate your CRM, database, or DMP with OneSignal to trigger personalized, real-time notifications and sync user messaging data at scale.
- [Building an integration with OneSignal: partner guide](https://documentation.onesignal.com/docs/en/building-an-integration-with-onesignal-partner-guide.md): Build, verify, and launch a OneSignal partner integration. Covers the APIs for messaging, user sync, custom events, event streams, and the identity lifecycle every partner must follow.

##### OneSignal as data source

- [Amplitude](https://documentation.onesignal.com/docs/en/amplitude.md): Integrate OneSignal with Amplitude to sync behavioral cohorts, track message events, and target Users across push, email, SMS, and in-app channels.
- [Databricks](https://documentation.onesignal.com/docs/en/databricks.md): Export OneSignal message events to Databricks and import Databricks behavioral events into OneSignal to trigger Journeys and personalize messaging.
- [Google BigQuery](https://documentation.onesignal.com/docs/en/bigquery.md): Export messaging event data to BigQuery and import custom events from BigQuery to trigger personalized campaigns.
- [Mixpanel](https://documentation.onesignal.com/docs/en/mixpanel.md): Integrate OneSignal with Mixpanel to sync behavioral cohorts, track message events, and target Users across push, email, SMS, and in-app channels.
- [Snowflake](https://documentation.onesignal.com/docs/en/snowflake.md): Connect OneSignal with Snowflake to export messaging event data and sync custom events from your datasets to trigger automated Journeys.
- [Segment (Twilio)](https://documentation.onesignal.com/docs/en/segment-onesignal-integration.md): Integrate OneSignal with Twilio Segment for user data and messaging events.

##### OneSignal as destination

- [Adobe Audience Manager](https://documentation.onesignal.com/docs/en/adobe-audience-manager.md): Learn how to integrate OneSignal with Adobe Audience Manager to sync audience segments and behavioral data, enabling targeted, multi-channel messaging campaigns that drive engagement, conversions, and revenue growth.
- [AlloyDB](https://documentation.onesignal.com/docs/en/alloydb.md): Sync custom events from Google AlloyDB to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [Amazon Athena](https://documentation.onesignal.com/docs/en/amazon-athena.md): Sync custom events from Amazon Athena to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [Amazon S3](https://documentation.onesignal.com/docs/en/s3.md): Sync custom events from Amazon S3 CSV files to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [Amplitude](https://documentation.onesignal.com/docs/en/amplitude.md): Integrate OneSignal with Amplitude to sync behavioral cohorts, track message events, and target Users across push, email, SMS, and in-app channels.
- [Apache Kafka](https://documentation.onesignal.com/docs/en/kafka.md): Sync custom events from Apache Kafka topics to OneSignal to trigger automated Journeys and personalized messaging campaigns based on real-time user behavior.
- [Amazon Redshift](https://documentation.onesignal.com/docs/en/amazon-redshift.md): Sync custom events from Amazon Redshift to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [Azure Synapse](https://documentation.onesignal.com/docs/en/azure-synapse.md): Sync custom events from Azure Synapse to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [ClickHouse](https://documentation.onesignal.com/docs/en/clickhouse.md): Connect ClickHouse to OneSignal as a custom event source: grant a read-only user, map event columns, and optimize queries for large event tables.
- [Confluent Cloud](https://documentation.onesignal.com/docs/en/confluent-cloud.md): Sync custom events from Confluent Cloud to OneSignal to trigger automated Journeys and personalized messaging campaigns based on real-time user behavior.
- [Databricks](https://documentation.onesignal.com/docs/en/databricks.md): Export OneSignal message events to Databricks and import Databricks behavioral events into OneSignal to trigger Journeys and personalize messaging.
- [Elasticsearch](https://documentation.onesignal.com/docs/en/elasticsearch.md): Sync custom events from Elasticsearch to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [Google BigQuery](https://documentation.onesignal.com/docs/en/bigquery.md): Export messaging event data to BigQuery and import custom events from BigQuery to trigger personalized campaigns.
- [Google Cloud SQL](https://documentation.onesignal.com/docs/en/google-cloud-sql.md): Sync custom events from Google Cloud SQL to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [Google Sheets](https://documentation.onesignal.com/docs/en/google-sheets.md): Sync custom events from Google Sheets to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [Greenplum](https://documentation.onesignal.com/docs/en/greenplum.md): Sync custom events from Greenplum to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [HubSpot](https://documentation.onesignal.com/docs/en/hubspot.md): Automate push notifications, emails, SMS, and in-app messaging from HubSpot Workflows using the native OneSignal integration.
- [Materialize](https://documentation.onesignal.com/docs/en/materialize.md): Sync custom events from Materialize to OneSignal to trigger automated Journeys and personalized messaging campaigns based on real-time user behavior.
- [Microsoft Fabric](https://documentation.onesignal.com/docs/en/microsoft-fabric.md): Sync custom events from Microsoft Fabric to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [Mixpanel](https://documentation.onesignal.com/docs/en/mixpanel.md): Integrate OneSignal with Mixpanel to sync behavioral cohorts, track message events, and target Users across push, email, SMS, and in-app channels.
- [MotherDuck](https://documentation.onesignal.com/docs/en/motherduck.md): Sync custom events from MotherDuck to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [MySQL](https://documentation.onesignal.com/docs/en/mysql.md): Sync custom events from MySQL to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [PostgreSQL](https://documentation.onesignal.com/docs/en/postgresql.md): Sync custom events from PostgreSQL to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [Pub/Sub](https://documentation.onesignal.com/docs/en/google-pubsub.md): Sync custom events from Google Pub/Sub to OneSignal to trigger automated Journeys and personalized messaging campaigns based on real-time user behavior.
- [SingleStore](https://documentation.onesignal.com/docs/en/singlestore.md): Sync custom events from SingleStore to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [Snowflake](https://documentation.onesignal.com/docs/en/snowflake.md): Connect OneSignal with Snowflake to export messaging event data and sync custom events from your datasets to trigger automated Journeys.
- [SQL Server](https://documentation.onesignal.com/docs/en/sql-server.md): Sync custom events from Microsoft SQL Server to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [Starburst Enterprise](https://documentation.onesignal.com/docs/en/starburst-enterprise.md): Sync custom events from Starburst Enterprise to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [Starburst Galaxy](https://documentation.onesignal.com/docs/en/starburst-galaxy.md): Sync custom events from Starburst Galaxy to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [Trino](https://documentation.onesignal.com/docs/en/trino.md): Sync custom events from Trino to OneSignal to trigger automated Journeys and personalized messaging campaigns based on user behavior.
- [Segment (Twilio)](https://documentation.onesignal.com/docs/en/segment-onesignal-integration.md): Integrate OneSignal with Twilio Segment for user data and messaging events.

##### Attribution

- [RevenueCat](https://documentation.onesignal.com/docs/en/revenuecat.md): Sync in-app purchase and subscription data from RevenueCat to OneSignal for personalized messaging.
- [Adjust](https://documentation.onesignal.com/docs/en/adjust.md): Correlate Adjust attribution and event callbacks with OneSignal users by passing the OneSignal External ID as an Adjust partner parameter.
- [BlueConic](https://documentation.onesignal.com/docs/en/blueconic.md): Configure BlueConic webhooks to sync profile and segment data into OneSignal in real time via the Update user API.

### Privacy & Security

#### Security credentials

- [SOC 2 Type II](https://documentation.onesignal.com/docs/en/soc-2-type-ii.md): OneSignal's SOC 2 Type II compliance certification and security controls.
- [ISO 27001](https://documentation.onesignal.com/docs/en/iso27001.md): What ISO/IEC 27001 covers, OneSignal's certified status for information security management, and certificate availability on request.
- [HIPAA](https://documentation.onesignal.com/docs/en/hipaa.md): Overview of OneSignal’s HIPAA compliance, including BAAs for enterprise customers.

#### Data privacy & regulatory compliance

- [GDPR & Individual Rights](https://documentation.onesignal.com/docs/en/gdpr-compliance.md): OneSignal provides the following solutions to help be GDPR compliant.
- [EU-US Data Privacy Framework](https://documentation.onesignal.com/docs/en/eu-us-data-privacy-framework.md): Why the EU-US Data Privacy Framework matters when transferring EU personal data to US companies, and confirmation that OneSignal is certified.
- [Email regulatory compliance](https://documentation.onesignal.com/docs/en/email-compliance.md): Learn how to comply with global privacy and communication regulations when sending marketing emails using OneSignal. This guide covers consent requirements, opt-out rules, and email content regulations across major regions, including the EU, US, Canada, and more.
- [SMS regulatory compliance](https://documentation.onesignal.com/docs/en/sms-regulatory-compliance.md): Understand SMS compliance requirements for every country OneSignal supports. Covers consent standards by message type, sender identification, opt-out, quiet hours, prohibited content, record-keeping, and fraud prevention.
- [Apple App Privacy Requirements](https://documentation.onesignal.com/docs/en/apple-app-privacy-requirements.md): Understand how to accurately disclose your use of OneSignal in your iOS app to comply with Apple's App Privacy requirements. Learn which data types OneSignal collects and how to report them in App Store Connect.
- [Google Play Data Safety Requirements](https://documentation.onesignal.com/docs/en/google-play-data-safety-requirements.md): Learn how to accurately complete the Google Play Data Safety form when using OneSignal. Understand what data is collected, how to disclose it, and ensure compliance with Google's privacy policies.
- [Data collection & security FAQs](https://documentation.onesignal.com/docs/en/data-questions.md): Learn how OneSignal protects your data, maintains compliance, and supports privacy regulations.
- [Data collected by the OneSignal SDK](https://documentation.onesignal.com/docs/en/data-collected-by-the-onesignal-sdk.md): Data fields the OneSignal SDK collects automatically, with user permission, or manually — and how to control collection for privacy compliance.
- [Handling personal data](https://documentation.onesignal.com/docs/en/handling-personal-data.md): How OneSignal handles personal data and how you can meet GDPR, CCPA, and privacy requirements.
- [Data taxonomy](https://documentation.onesignal.com/docs/en/data-taxonomy.md): How OneSignal classifies data into Customer Content, Subscriber Data, Usage Data, and OneSignal Analytics Data, who controls each category, and which agreement governs it.
- [OneSignal AI data practices](https://documentation.onesignal.com/docs/en/ai-data-practices.md): What data OneSignal AI uses, how long it is retained, the controls you have, and what OneSignal does and does not do with that data.

#### Authentication

- [2-step authentication](https://documentation.onesignal.com/docs/en/2-step-authentication.md): Set up, manage, and recover 2-step authentication (2FA) for your OneSignal account, including recovery codes, transferring to a new device, and regaining access if locked out.
- [Single Sign-On (SSO)](https://documentation.onesignal.com/docs/en/sso.md): Configure SSO (SAML 2.0 or OIDC) for your OneSignal organization so team members authenticate through your identity provider.
