NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #2826 most downloaded on pub.dev
Gleap SDK for Flutter: customer support, live chat, in-app bug reporting and customer feedback.
Latest stable
19.5.1
Last release 15 days ago
07 Nov 2026
Release timing varies
gaps range from 8 days to 2 months
Nearly every release is documented
notes for 59 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
5 years old
162 releases · first in 2021
Drag across the ruler to compare, or tap a release to open it.
Documentation only: README, package description and doc comments name the Project ID (Settings → Project → General) and sign users in with setUserJwt.
Documentation only: README, package description and doc comments name the Project ID (Settings → Project → General) and sign users in with setUserJwt. No code changes.
New: Gleap.initialize(projectId: 'YOUR_PROJECT_ID'). token: keeps working and is marked @Deprecated. The Project ID is in the Gleap dashboard under Se…
The key Gleap.initialize takes is now called Project ID (formerly "SDK key" / "API key"). The value is the same and every existing key keeps working; nothing needs to change in your app.
New: Gleap.initialize(projectId: 'YOUR_PROJECT_ID'). token: keeps working and is marked @Deprecated. The Project ID is in the Gleap dashboard under Settings → Project → General. The plugin passes it to the native initializeWithProjectId: (iOS, falling back to initializeWithToken: on older native SDKs) and Gleap.initialize(String, Application) (Android), and to Gleap.initialize(projectId) of the JavaScript SDK on web.
Fix: setUserJwtProvider now installs the method channel handler itself, so the provider answers the native SDK's token requests even when the Dart initialize has not run in this engine (the SDK was initialized natively, or after a hot restart). Setting the provider before or after initialize both work.
With the native SDKs 19.5.0, the setUserJwtProvider provider also restores the signed session after an app restart.
Updated native iOS dependency to 19.5.0
Updated native Android dependency to 19.5.0
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Customer identity: Gleap.setUserJwt(token:), Gleap.setUserJwtProvider(provider:) and Gleap.setAuthTokens(tokens:) wrap the native SDK methods on Andro
Customer identity: Gleap.setUserJwt(token:), Gleap.setUserJwtProvider(provider:) and Gleap.setAuthTokens(tokens:) wrap the native SDK methods on Android and iOS and the JavaScript SDK on web. setUserJwt identifies the user with one HS256 JWT signed by your backend (the token is the whole identify, kept in memory only); setAuthTokens stores per-user tokens for API tools on the signed contact (a null value removes one). The provider runs in Dart: the native (or JavaScript) SDK asks for a token when the current one expired or expires within 5 minutes and keeps the rules (one call at a time, 10 second timeout, 30 second pause after a failure); a thrown error or null counts as a failure. Needs native SDKs with these methods (the next synchronized native release) and, on web, a JavaScript SDK with them.
Fix: identify / identifyContact dropped the userHash when userProperties was null; the hash is now sent with or without user properties (on Android too). New: Gleap.setSessionDuration(milliseconds:) shortens the signed session (the project's maximum applies); on web it goes to the JavaScript SDK's initialize option and Gleap.setSessionDuration.
Updated native iOS dependency to 19.4.0 Updated native Android dependency to 19.4.0
Updated native iOS dependency to 19.3.1 Updated native Android dependency to 19.3.1
Updated native iOS dependency to 19.3.1 Updated native Android dependency to 19.3.1
Inline banners on Android and iOS can push the app down instead of covering it, like on the web. Wrap the app in GleapBannerArea (for example Material
Inline banners on Android and iOS can push the app down instead of covering it, like on the web. Wrap the app in GleapBannerArea (for example MaterialApp(builder: (context, child) => GleapBannerArea(child: child!))): while an inline banner is shown, the app moves down by the banner's height (animated) and its top safe-area padding shrinks by the same amount, since the banner covers the status bar. Floating banners still float above the app. Gleap.bannerHeight is a ValueListenable<double> with the current height in logical pixels for custom layouts.
Updated native iOS dependency to 19.3.0
Updated native Android dependency to 19.3.0
Android: the realtime socket opens and closes far less often (no reconnect on a network change or an unchanged identify, closed with 1001 after 10 s i
Android: the realtime socket opens and closes far less often (no reconnect on a network change or an unchanged identify, closed with 1001 after 10 s in the background, backoff reset only after a healthy socket); see the Android SDK 19.2.4 notes. Updated native iOS dependency to 19.2.4 Updated native Android dependency to 19.2.4
iOS: the realtime socket opens and closes far less often and closes cleanly (close codes 1000/1001 instead of none, one socket per session start and i
iOS: the realtime socket opens and closes far less often and closes cleanly (close codes 1000/1001 instead of none, one socket per session start and identify, backoff after errors, closed in the background); see the iOS SDK 19.2.3 notes. Updated native iOS dependency to 19.2.3 Updated native Android dependency to 19.2.3
iOS: sending a form or bug report no longer freezes the app for seconds (no loading state after Submit, late thank-you screen); see the iOS SDK 19.2.2
iOS: sending a form or bug report no longer freezes the app for seconds (no loading state after Submit, late thank-you screen); see the iOS SDK 19.2.2 notes. Updated native iOS dependency to 19.2.2 Updated native Android dependency to 19.2.2
Updated native iOS dependency to 19.2.1 Updated native Android dependency to 19.2.1
Updated native iOS dependency to 19.2.1 Updated native Android dependency to 19.2.1
Updated native iOS dependency to 19.2.0 Updated native Android dependency to 19.2.0 Surveys 2.0: the feedback sent and outbound sent callbacks (and on
Updated native iOS dependency to 19.2.0 Updated native Android dependency to 19.2.0 Surveys 2.0: the feedback sent and outbound sent callbacks (and on Android feedback will be sent) now also fire when a Surveys 2.0 survey is completed in the native SDKs, with the survey's answers; server-triggered surveys keep their resume data, and full-screen and card surveys look right on Android (native SDK 19.2.0).
Updated native iOS dependency to 19.1.0 Updated native Android dependency to 19.1.0 New Gleap.setCaptureEnabled(enabled: ...) and Gleap.setRemoteLogCo
Updated native iOS dependency to 19.1.0
Updated native Android dependency to 19.1.0
New Gleap.setCaptureEnabled(enabled: ...) and Gleap.setRemoteLogCollectionEnabled(enabled: ...) for capture requests: in-app screenshots and screen recordings that workflows, AI agents and teammates ask for in a conversation, and background log collection (on the web through the JavaScript SDK). Network logs from Dart are handed to the native SDK before it collects logs for a request.
Added Gleap.openProtectedFileFromUrl(url: ...) to open the conversation of a protected file from an emailed file link. (With "Require authenticated fi
Added Gleap.openProtectedFileFromUrl(url: ...) to open the conversation of a protected file from an emailed file link.
(With "Require authenticated file access", email replies link attachments to your customer application URL with a gleapFile query parameter. Pass the link that opened the app, e.g. from app_links or uni_links; it returns true if the link carries a Gleap file reference, and the conversation opens once the user is identified with a user hash (identifyContact with userHash). On web the JavaScript SDK opens ?gleapFile= links on page load by itself, so it returns false there)
Native iOS and Android dependencies stay on 19.0.0
iOS: Swift Package Manager is now the recommended setup; CocoaPods is still supported. (CocoaPods trunk becomes read-only on December 2, 2026. The plu
iOS: Swift Package Manager is now the recommended setup; CocoaPods is still supported.
(CocoaPods trunk becomes read-only on December 2, 2026. The plugin's Package.swift pulls the Gleap iOS SDK from GitHub (from: "19.0.0") and now follows Flutter's current plugin layout: it depends on the FlutterFramework package and the public header moved to include/gleap_sdk/. Flutter uses it when Swift Package Manager is on, which is the default from Flutter 3.44; it needs Flutter 3.41 or newer (the FlutterFramework package), on 3.41 to 3.43 turn it on with flutter config --enable-swift-package-manager. Older Flutter versions, or Swift Package Manager turned off, keep using the podspec as before (the Flutter minimum stays 3.19; apps that turned Swift Package Manager on with Flutter 3.24 to 3.40 turn it off again or upgrade Flutter to 3.41+). iOS deployment target 15.0 as before. CocoaPods apps that upgrade run pod update Gleap gleap_sdk once; for Gleap iOS SDK versions released after December 2, 2026 they add pod 'Gleap', :git => 'https://github.com/GleapSDK/Gleap-iOS-SDK.git', :tag => '<version>' to their Podfile, see README → iOS installation. Both use the same sources in ios/gleap_sdk/Sources/gleap_sdk/)
Updated native iOS dependency to 19.0.0
Updated native Android dependency to 19.0.0
Added Gleap.setColorScheme(colorScheme: 'auto' | 'light' | 'dark', lightBackgroundColor: ..., darkBackgroundColor: ...) to switch the widget between dark and light mode. It overrides the color scheme set in the Gleap dashboard (only when "Adapt to dark / light mode" is enabled there).
(auto follows the device appearance on Android and iOS and the page theme on web; apps with their own in-app theme toggle should pass light / dark explicitly, e.g. from Theme.of(context).brightness, and call it again when the theme changes. Before the first call the dashboard setting applies. In dark mode the widget uses the dark mode colors, logo, header image and composer glow set in the Gleap dashboard; without dark colors it keeps its normal colors. lightBackgroundColor / darkBackgroundColor override the background in light / dark mode. Can be called before or after Gleap.initialize and applies live)
Web: requires the Gleap JavaScript SDK 19.0.0 or newer. To call setColorScheme before the JavaScript SDK has loaded, use the updated loader snippet from the README (adds it to the pre-load queue, together with methods that were missing there: updateContact, startClassicForm, startConversation, openChecklists, openChecklist, startChecklist, setTicketAttribute, unsetTicketAttribute, clearTicketAttributes, registerAgentTool, startNetworkLogger, setNetworkLogsBlacklist, setNetworkLogPropsToIgnore and setDisableInAppNotifications).
Added Gleap.logNetworkRequest(networkLog) for logging network requests one by one (used by the Gleap http and dio interceptors 2.0). All logged requests share one buffer with the newest 30 entries, so several interceptors no longer overwrite each other, and the list is handed to the native SDK at most every 500 ms instead of on every request. Gleap.attachNetworkLogs still replaces the list.
Added Gleap.startNetworkLogging() / Gleap.stopNetworkLogging() to switch network logging on and off from the app, also against the network logs setting in the dashboard (without them nothing changes). After stopNetworkLogging, logNetworkRequest and attachNetworkLogs (and with them the Gleap http and dio interceptors) ignore new requests on all platforms; requests logged before stay attached.
(iOS: also starts / stops the native recording of every NSURLSession request, e.g. made by native plugins or cupertino_http; an explicit stop also applies once the config has loaded. Web: startNetworkLogging also starts the JavaScript SDK's network logger for fetch and XMLHttpRequest, which the JavaScript SDK can't stop, so on web stopNetworkLogging only stops the requests logged from Dart)
Network log entries now have the same shape as in the other Gleap SDKs: the request start date in ISO-8601 UTC, the duration in whole milliseconds, Map and List bodies as JSON (instead of Dart's {a: b} syntax), bodies capped at 150 KB with a truncation note, response headers, and an errorText for requests that failed without a response (new headers and errorText on GleapNetworkResponse).
setNetworkLogPropsToIgnore and setNetworkLogsBlacklist now also apply in Dart before the logs leave the app: matching headers, JSON keys (at any depth; user.password also works as a path), form fields and url query parameters are removed (case-insensitive), authorization and cookie headers are always masked, and requests to gleap.io / gleap.ai are never logged. Each call replaces the previous list.
Fixed await Gleap.attachNetworkLogs(...) never completing on iOS, and setNetworkLogsBlacklist, setNetworkLogPropsToIgnore, preFillForm, startBot, startClassicForm and startConversation (and addAttachment with an unreadable file) never completing on Android.
Android: attached network logs keep their date and method (HEAD, OPTIONS etc. no longer fail), one incomplete entry no longer drops the whole list, and attaching replaces the previous list instead of adding duplicates.
Android: openChecklist started the checklist instead of opening it, getIdentity returned the contact's value as its sla, and getIdentity returned an empty identity instead of null when there is none (as on iOS and web).
Web: showBackButton was ignored by startConversation, startBot and startClassicForm.
Web: network logs logged before the JavaScript SDK has loaded are handed over once it is initialized instead of throwing.
Updated native iOS dependency to 18.1.0 Updated native Android dependency to 18.1.0 Added Gleap.setEnvDataPropsToIgnore(propsToIgnore: [...]) to drop
Updated native iOS dependency to 18.1.0
Updated native Android dependency to 18.1.0
Added Gleap.setEnvDataPropsToIgnore(propsToIgnore: [...]) to drop individual env data fields and Gleap.setDisableEnvData(disable: true) to stop collecting env data entirely.
(env data keys are exact and case-sensitive, e.g. deviceName, batteryLevel, currentUrl; each setEnvDataPropsToIgnore call replaces the previous list and an empty list resets it; both can be called before or after Gleap.initialize and apply to the next ticket)
Web: requires the Gleap JavaScript SDK 18.1.0 or newer. To call the new methods before the JavaScript SDK has loaded, use the updated loader snippet from the README (adds them to the pre-load queue).
No breaking changes: major version aligned across all Gleap SDKs for the data-region release. Without Gleap.setRegion the SDK behaves exactly as 17.x…
No breaking changes: major version aligned across all Gleap SDKs for the data-region release. Without Gleap.setRegion the SDK behaves exactly as 17.x (EU hosts).
Updated native iOS dependency to 18.0.0
Updated native Android dependency to 18.0.0
Added data regions: Gleap.setRegion(region: 'eu' | 'us') (call before Gleap.initialize) sets the API url, the websocket API url and the realtime host for the region at once. The default region stays eu.
(eu: api.gleap.io, ws.gleap.io, sockets.gleap.io; us: api.us.gleap.ai, ws.us.gleap.ai, sockets.us.gleap.ai; the static widget hosts are global and never changed by setRegion)
Added manual host setters Gleap.setWSApiUrl(url:), Gleap.setRealtimeHost(host:), Gleap.setBannerUrl(url:) and Gleap.setModalUrl(url:) next to the existing setApiUrl / setFrameUrl. A manual setter called after setRegion overrides that single host.
Web: requires the Gleap JavaScript SDK 18.0.0 or newer and the updated loader snippet from the README (adds the new methods to the pre-load queue).
iOS Swift Package Manager: the Gleap-iOS-SDK package requirement is now from: "18.0.0".
Updated native Android dependency to 17.0.1 (fixes an IllegalStateException crash from the chat image cache when the app is backgrounded after a cache
Updated native Android dependency to 17.0.1 (fixes an IllegalStateException crash from the chat image cache when the app is backgrounded after a cached image was released; memory-trim callbacks can no longer take the host app down) Native iOS dependency stays on 17.0.0 (unaffected)
Updated native iOS dependency to 17.0.0 Updated native Android dependency to 17.0.0 (Android: remote images are now downsampled to their destination s
Updated native iOS dependency to 17.0.0 Updated native Android dependency to 17.0.0 (Android: remote images are now downsampled to their destination size and served from a memory-pressure-aware cache, replacing the manual full-size bitmap decodes flagged by Google Play's new Android Vitals bitmap-optimization advisory; both platforms: calling setLanguage() after initialize() now reloads the widget config, so server-translated copy switches language immediately)
Updated native iOS dependency to 16.4.5 Updated native Android dependency to 16.4.5 (redesigned in-app notifications: contained cards with the sender
Updated native iOS dependency to 16.4.5 Updated native Android dependency to 16.4.5 (redesigned in-app notifications: contained cards with the sender and time inside the card, a collapsible notification stack, and the rounded-square bot avatar — matching the JavaScript SDK)
Updated native iOS dependency to 16.4.3 (fixes info cards scrolling in two places at once, and flickering in portrait, when the content is taller than
Updated native iOS dependency to 16.4.3 (fixes info cards scrolling in two places at once, and flickering in portrait, when the content is taller than the screen) Native Android dependency stays on 16.4.2 (unaffected)
Updated native iOS dependency to 16.4.2 Updated native Android dependency to 16.4.2 (shows the app background while the widget is loading and raises t
Updated native iOS dependency to 16.4.2 Updated native Android dependency to 16.4.2 (shows the app background while the widget is loading and raises the attachment file size limit)
Updated native iOS dependency to 16.4.0 Updated native Android dependency to 16.4.0 (fixes Gleap not responding when the app is launched without an in
Updated native iOS dependency to 16.4.0 Updated native Android dependency to 16.4.0 (fixes Gleap not responding when the app is launched without an internet connection)
Updated native iOS dependency to 15.4.0 Updated native Android dependency to 15.4.0
Updated native iOS dependency to 15.4.0 Updated native Android dependency to 15.4.0
Updated native iOS dependency to 15.3.4 (fixes the feedback button disappearing after launch on iOS in apps where the key window changes)
Updated native iOS dependency to 15.3.4 (fixes the feedback button disappearing after launch on iOS in apps where the key window changes)
Nothing published for this version
Raised Android compileSdkVersion to 34 Added Swift Package Manager support for iOS
Raised Android compileSdkVersion to 34 Added Swift Package Manager support for iOS
Updated native iOS dependency to 15.3.0 Updated native Android dependency to 15.3.0
Updated native iOS dependency to 15.3.0 Updated native Android dependency to 15.3.0
Updated native iOS dependency to 15.2.5
Updated native iOS dependency to 15.2.5
Updated native Android dependency to 15.2.6
Updated native Android dependency to 15.2.6
Updated native iOS dependency to 15.2.3
Updated native iOS dependency to 15.2.3
Updated native Android dependency to 15.2.3
Updated native Android dependency to 15.2.3
Updated native Android dependency to 15.2.2 Updated native iOS dependency to 15.2.1
Updated native Android dependency to 15.2.2 Updated native iOS dependency to 15.2.1
Updated native Android dependency to 15.2.1
Updated native Android dependency to 15.2.1
Added setNotificationContainerOffset Updated native iOS dependency to 15.2.0 Updated native Android dependency to 15.2.0
Added setNotificationContainerOffset Updated native iOS dependency to 15.2.0 Updated native Android dependency to 15.2.0
Updated native Android dependency to 15.0.2
Updated native Android dependency to 15.0.2
Updated native iOS dependency to 15.0.1 Updated native Android dependency to 15.0.1
Updated native iOS dependency to 15.0.1 Updated native Android dependency to 15.0.1
Updated native iOS dependency to 15.0.0 Updated native Android dependency to 15.0.0 Added askAI to directly ask Kai a question by code.
Updated native iOS dependency to 15.0.0 Updated native Android dependency to 15.0.0 Added askAI to directly ask Kai a question by code.
Updated native Android dependency to 14.8.4
Updated native Android dependency to 14.8.4
Updated native Android dependency to 14.8.3
Updated native Android dependency to 14.8.3
Updated native Android dependency to 14.8.2
Updated native Android dependency to 14.8.2
Updated native iOS dependency to 14.8.0 Updated native Android dependency to 14.8.0
Updated native iOS dependency to 14.8.0 Updated native Android dependency to 14.8.0
Updated native iOS dependency to 14.7.6 Updated native Android dependency to 14.7.6
Updated native iOS dependency to 14.7.6 Updated native Android dependency to 14.7.6
Updated native iOS dependency to 14.7.5 Updated native Android dependency to 14.7.5
Updated native iOS dependency to 14.7.5 Updated native Android dependency to 14.7.5
Updated native iOS dependency to 14.7.1 Updated native Android dependency to 14.7.3
Updated native iOS dependency to 14.7.1 Updated native Android dependency to 14.7.3
Updated native Android dependency to 14.7.1 Fixed issue with banners on Android
Updated native Android dependency to 14.7.1 Fixed issue with banners on Android
Updated native iOS dependency to 14.7.0 Updated native Android dependency to 14.7.0
Updated native iOS dependency to 14.7.0 Updated native Android dependency to 14.7.0
Updated native iOS dependency to 14.6.5 Updated native Android dependency to 14.6.5
Updated native iOS dependency to 14.6.5 Updated native Android dependency to 14.6.5
Updated native iOS dependency to 14.6.2 Updated native Android dependency to 14.6.3
Updated native iOS dependency to 14.6.2 Updated native Android dependency to 14.6.3
Updated native iOS dependency to 14.6.1 Updated native Android dependency to 14.6.1
Updated native iOS dependency to 14.6.1 Updated native Android dependency to 14.6.1
Updated native iOS dependency to 14.6.0 Updated native Android dependency to 14.6.0
Updated native iOS dependency to 14.6.0 Updated native Android dependency to 14.6.0
Added avatar to GleapUserProperty Updated native iOS dependency to 14.5.0 Updated native Android dependency to 14.5.0
Added avatar to GleapUserProperty Updated native iOS dependency to 14.5.0 Updated native Android dependency to 14.5.0
Added lang to GleapUserProperty Updated native iOS dependency to 14.2.2 Updated native Android dependency to 14.2.5
Added lang to GleapUserProperty Updated native iOS dependency to 14.2.2 Updated native Android dependency to 14.2.5
Updated native iOS dependency to 14.2.0 Updated native Android dependency to 14.2.0
Updated native iOS dependency to 14.2.0 Updated native Android dependency to 14.2.0
Updated native Android dependency to 14.1.3
Updated native Android dependency to 14.1.3
Updated native Android dependency to 14.1.1
Updated native Android dependency to 14.1.1
Updated native iOS dependency to 14.1.0 Updated native Android dependency to 14.1.0 Added unsetTicketAttribute, clearTicketAttributes
Updated native iOS dependency to 14.1.0 Updated native Android dependency to 14.1.0 Added unsetTicketAttribute, clearTicketAttributes
Updated native iOS dependency to 14.0.5 Updated native Android dependency to 14.0.5
Updated native iOS dependency to 14.0.5 Updated native Android dependency to 14.0.5
Updated native iOS dependency to 14.0.4 Updated native Android dependency to 14.0.2 Included PRs from @importRyan (Many thanks for contributing!)
Updated native iOS dependency to 14.0.4 Updated native Android dependency to 14.0.2 Included PRs from @importRyan (Many thanks for contributing!)
Updated native dependencies to 14.0.1
Updated native dependencies to 14.0.1
Fixed issue with updateContact
Fixed issue with updateContact
Updated native dependencies to 14.0.0 Added outbound-sent delegate
Updated native dependencies to 14.0.0 Added outbound-sent delegate
One column per quarter.