Mobile sources (iOS & Android)
Mobile sources (iOS and Android) share most features with website sources, but some options are adapted for native apps. This page covers the differences.
iOS and Android sources are identical in the dashboard — the only difference is the Installation page, which is specific to each platform. See iOS SDK Installation and Android SDK Installation.
Source sidebar
Mobile sources have the following sections in their sidebar:
- Surveys — create and manage in-app surveys
- Audience — manage audiences and user segments
- AI agents — configure AI-powered chat agents
- Settings — Installation, General, Debugger
Product tours are only available on website sources. They do not appear in the sidebar of mobile sources.
Settings
Installation
The Installation page is a guided wizard to set up the SDK in your mobile app. It is specific to each platform:
- iOS: 4 steps — Add application ID, Add Told to dependencies (CocoaPods), Install Told (
pod install), Initialize the SDK. See iOS SDK Installation. - Android: 4 steps — Add application ID, Add Told to dependencies (Gradle), Add permissions, Initialize the SDK. See Android SDK Installation.
General
The General settings page has the same sections as website sources — Tag, Email preferences, and Events — but with fewer event options.
Events
On mobile sources, only one event is available:
| Event | Default | Description |
|---|---|---|
| Visited page | On | Records each page/screen change within your source to track user navigation |
The website-only events (Click, Scroll, Google Tag Manager) are not available on mobile sources.
Debugger
The Debugger page (sidebar Settings → Debugger) is a real-time monitoring tool that shows SDK events as they come in. It works the same way on mobile and website sources.
It displays a live feed of events with two filters:
- Type filter — a dropdown to filter by event type. Available types:
CHANGE_PAGE,CLOSE_SURVEY,CUSTOM_EVENT,GROUP,IDENTIFY,NEW_ANSWER,ON_CLICK,ON_SCROLL,REACH_END,RESET,START_SESSION,START_SURVEY, or "All Types". - Date filter — "From" and "To" date pickers. By default, results are filtered on the last day.
The debugger is useful for verifying that your SDK is correctly sending events after installation. If the feed is empty, make sure the SDK is initialized and your app is sending events.
Surveys on mobile
Creating and editing surveys works the same way as on website sources: you have Content (Questions + Customization), Publish, Results, and Preview tabs.
The differences are in Triggers and Customization.
Triggers
Mobile sources have two trigger types instead of the three available on website:
| Trigger | Description |
|---|---|
| Screen name | Triggers the survey when the user navigates to a specific screen. The screen name must match the value passed via the SDK (e.g., Told.setScreen("Home") on iOS or equivalent on Android). |
| Custom event | Triggers the survey when a custom event is fired from your app via the SDK. You specify the event name and optionally filter by properties. |
The website-only triggers (Page visit and Click on an element) are not available on mobile sources.
Customization
Mobile survey customization has fewer options than website:
| Option | Mobile | Website |
|---|---|---|
| Color | Yes | Yes |
| Avatar | Yes | Yes |
| Close | Yes | Yes |
| Badge | Yes | Yes |
| Cover | No | Yes |
| Position | No | Yes |
| Overlay | No | Yes |
| Theme toggle | No | Yes |
Audience & Period
The Audience and Period sections work exactly the same as on website sources. You can target specific audiences and configure scheduling, recurrence, and display-once rules.