---
title: Compatibility - Flutter
description: Requirements and limitations to develop with the Flutter SDK
source_url:
  html: https://docs.contentsquare.com/en/csq-sdk-flutter/experience-analytics/compatibility/
  md: https://docs.contentsquare.com/en/csq-sdk-flutter/experience-analytics/compatibility/index.md
---

> ## Documentation index
> Fetch the complete documentation index at: https://docs.contentsquare.com/llms.txt
> Use this file to discover all available pages before exploring further.

Before implementing the SDK, make sure your app meets the following technical prerequisites to avoid integration issues and ensure optimal performance.

## Supported platforms

Only Flutter application on the following platforms are supported by the CSQ Flutter SDK:

* Android
* iOS

Calling the SDK on other platforms is safe but will not have any effect.

If you need to use the SDK on another platform, contact our support team.

Note

Hybrid applications are not supported. By hybrid application, we mean iOS and Android apps that integrate Flutter as an [add-to-app module ↗](https://docs.flutter.dev/add-to-app).

## Compatibility matrix

Each version of the CSQ Flutter SDK will be linked to specific, fixed versions of each native SDK. To make that clear, here is a compatibility table to consider when choosing your version of the bridge (refer to the Flutter SDK Changelog to know what the changes are for each version).

Note

If the Maximum Flutter Version is not specified, it means that the bridge is compatible with all versions of Flutter up to the latest one.

Don't migrate to material_ui or cupertino_ui yet

Flutter 3.47 moves Material and Cupertino into the standalone `material_ui` and `cupertino_ui` packages. The Contentsquare Flutter SDK doesn't support them yet.

If you migrate, the SDK keeps sending events but captures degraded data: unnamed routes go untracked, interactions lose widget identity, and Session Replay masking can flip. Your app still builds and runs but there's no error and no drop in event volume, making the issue hard to detect.

Wait for an official SDK release supporting these packages. Bundled imports are deprecated in the fall 2026 stable release (expected November 2026) and removed in 2027.

| CSQ Flutter | CSQ iOS | CSQ Android | Minimum Flutter Version | Maximum Flutter Version |
| - | - | - | - | - |
| 4.5.2 | 1.12.3 | 1.12.3 | 3.27.0 | - |
| 4.5.1 | 1.12.3 | 1.12.3 | 3.27.0 | - |
| 4.5.0 | 1.12.2 | 1.12.2 | 3.27.0 | - |
| 4.4.4 | 1.11.1 | 1.11.0 | 3.27.0 | - |
| 4.4.3 | 1.11.1 | 1.11.0 | 3.27.0 | - |
| 4.4.2 | 1.11.1 | 1.11.0 | 3.27.0 | - |
| 4.4.1 | 1.11.0 | 1.11.0 | 3.27.0 | - |
| 4.4.0 | 1.11.0 | 1.11.0 | 3.27.0 | - |
| 4.3.1 | 1.11.0 | 1.11.0 | 3.27.0 | - |
| 4.3.0 | 1.11.0 | 1.11.0 | 3.27.0 | - |
| 4.2.2 | 1.10.0 | 1.10.1 | 3.27.0 | - |
| 4.2.1 | 1.10.0 | 1.10.1 | 3.27.0 | - |
| 4.2.0 | 1.10.0 | 1.10.1 | 3.27.0 | - |
| 4.1.3 | 1.6.0 | 1.5.0 | 3.27.0 | - |
| 4.1.2 | 1.6.0 | 1.5.0 | 3.27.0 | - |
| 4.1.1 | 1.6.0 | 1.5.0 | 3.27.0 | - |
| 4.1.0 | 1.6.0 | 1.5.0 | 3.27.4 | - |
| 4.0.3 | 1.5.2 | 1.4.7 | 3.22.3 | - |
| 4.0.2 | 1.5.2 | 1.4.2 | 3.22.3 | - |
| 4.0.1 | 1.5.2 | 1.4.2 | 3.22.3 | - |
| 4.0.0 | 1.5.1 | 1.4.2 | 3.22.3 | - |


```json
{"@context":"https://schema.org","@type":"TechArticle","headline":"Compatibility","description":"Requirements and limitations to develop with the Flutter SDK","url":"https://docs.contentsquare.com/en/csq-sdk-flutter/experience-analytics/compatibility/","inLanguage":"en","dateModified":"2026-03-11T15:27:52+01:00","publisher":{"@type":"Organization","name":"Contentsquare","url":"https://www.contentsquare.com/"},"isPartOf":{"@type":"WebSite","@id":"https://docs.contentsquare.com/#website","name":"Contentsquare Technical Documentation","url":"https://docs.contentsquare.com/"}}
```