Legacy Mode

📘

Legacy Mode

Your app will integrate with the latest OneSignal iOS and Android SDKs (v5+) and user-centric data model by default. With Legacy Mode enabled your app will instead fall back to OneSignal’s previous iOS v3 SDK and Android v4 SDK, which both support the device-centric data model. To migrate your app disable this setting and refer to OneSignal’s User Model Migration Guide as linked in our documentation.

Migration to user-centric data model

To migrate an existing app to OneSignal's user-centric data model refer to their User Model Migration Guide prior to disabling legacy mode.

The primary changes to consider are when associating users and devices, and delivering programmatic transactional notifications. For support of this functionality is the user-centric data model refer to our documentation on User Management and Programmatic Notifications.