NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
pub.dev
pub.dev, #2708 most downloaded on pub.dev
Appwrite is an open-source self-hosted backend server that abstracts and simplifies complex and repetitive development tasks behind a very simple REST API
Latest stable
28.4.0
Last release 6 days ago
16 Nov 2026
Ships on a steady schedule
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
7 years old
129 releases · first in 2020
Drag across the ruler to compare, or tap a release to open it.
Added: Tracking.start() sends first_open once per install and app_updated ( previousVersion , version ) on the first start after the app's version cha
Tracking.start() sends first_open once per install and app_updated (previousVersion, version) on the first start after the app's version changesPush.setTracking sends push_received and push_opened with the message's messageId; Tracking.pushReceived and Tracking.pushOpened for other push providersPushNotificationOpened.messageIdAccount.createDevice, getDevice, deleteDevice and updateDeviceSession, and the Device modelAccount.createLDAPSessionSession.userNameauto output on Storage.getFilePreview and the avatar endpoints, serving avif or webp when the Accept header supports itOAuthProvider.naver and OAuthProvider.vippsSandboxFOREGROUND_SERVICE and FOREGROUND_SERVICE_REMOTE_MESSAGING; apps that call push.setForeground(true) declare themX-Appwrite-Response-Format: 2.7.2Full Changelog: 28.4.0-rc.1...28.4.0
28.4.0 Latest
Latest
Compare
Your coding agent can read these notes before it upgrades. Set up the MCP server →
Added: Tracking.start() sends first_open once per install and app_updated ( previousVersion , version ) on the first start after the app's version cha
Tracking.start() sends first_open once per install and app_updated (previousVersion, version) on the first start after the app's version changesPush.setTracking sends push_received and push_opened with the message's messageId; Tracking.pushReceived and Tracking.pushOpened for other push providersPushNotificationOpened.messageIdAccount.createDevice, getDevice, deleteDevice and updateDeviceSession, and the Device modelSession.userNameauto output on Storage.getFilePreview and the avatar endpoints, serving avif or webp when the Accept header supports itOAuthProvider.naver and OAuthProvider.vippsSandboxX-Appwrite-Response-Format: 2.7.2Added: optional interactive param on Analytics.createEvent to mark an event as telemetry that does not end a bounce
interactive param on Analytics.createEvent to mark an event as telemetry that does not end a bounceapp_backgrounded and app_foregrounded with interactive: falseClient.setEnvironment to act in a project environment; realtime connections carry itOAuthProvider.vippsX-Appwrite-Response-Format: 2.7.0; the SDK targets Appwrite 2.7.xFull Changelog: 28.2.1...28.3.0
Added: optional interactive param on Analytics.createEvent to mark an event as telemetry that does not end a bounce
interactive param on Analytics.createEvent to mark an event as telemetry that does not end a bounceapp_backgrounded and app_foregrounded with interactive: falseClient.setEnvironment to act in a project environment; realtime connections carry itOAuthProvider.vippsX-Appwrite-Response-Format: 2.7.0; the SDK targets Appwrite 2.7.xFull Changelog: 28.2.1...28.3.0-rc.1
Fixed: web Push uses package:web instead of the deprecated dart:html
Push uses package:web instead of the deprecated dart:htmlhttp version raised to 1.1.1Full Changelog: 28.2.0...28.2.1
Updated: requests send X-Appwrite-Response-Format: 2.6.2 ; the SDK targets Appwrite 2.6.x
X-Appwrite-Response-Format: 2.6.2; the SDK targets Appwrite 2.6.x. and .. throw AppwriteExceptionnull for unset optional params instead of empty stringsFull Changelog: 28.1.0...28.2.0
Added: createQuery on databases , documentsDB and tablesDB to send list queries in the request body
createQuery on databases, documentsDB and tablesDB to send list queries in the request bodyaccount.listMembershipsbundleId and environment on account.createPushTarget and account.updatePushTarget for APNs routingfailure URLFull Changelog: 28.0.0...28.1.0
Breaking: requests send X-Appwrite-Response-Format: 2.5.0 ; responses follow the 2.5 shapes
X-Appwrite-Response-Format: 2.5.0; responses follow the 2.5 shapesClient.chunkedUpload takes a responseType parameter; custom Client implementations must add it>=3.10.0 and Flutter >=3.38.1Client adds setPushEndpoint, setPushClientId and flatten; custom Client implementations must add themApps service to manage apps, installations, keys and secretsOauth2 service for the OAuth2 authorize, token, device and grant flowsPush service with background delivery on AndroidTopic helper and MQTT exportsio.appwrite.flutter, so apps can also depend on sdk-for-android; set the notification icon with the io.appwrite.flutter.push.notification_icon meta-dataQuery aggregates (count, countDistinct, sum, avg, min, max and more), groupBy, having, distinct, joins, relationship, covers, spatialEquals and pageQuery.builder() to chain queries; build() returns the query listExecutionTrigger.emailprefs, default to an empty mapprompt value in a listAdded: analytics.createEvent in a new Analytics service to send tracking events
analytics.createEvent in a new Analytics service to send tracking eventsTracking helper for app lifecycle events and screen views, and TrackingObserver for automatic route trackingavatars.updatePhoto and avatars.deletePhoto to manage the user's custom profile photo, and the Account modelWebflow to the OAuthProvider enumstate on account.createOAuth2Session and account.createOAuth2Token, returned unchanged on the success and failure URLsduration on account.createEmailPasswordSession to set the session lengthcurrent on account.deleteSessions to keep the current session signed inmembershipId on teams.createMembershiptotal on account.listSessions, the locale list methods and listTransactionsFull Changelog: 27.1.0...27.2.0
Added: account passkey methods listPasskeys , createPasskey , getPasskey , updatePasskey , deletePasskey and updatePasskeyVerification
account passkey methods listPasskeys, createPasskey, getPasskey, updatePasskey, deletePasskey and updatePasskeyVerificationaccount.createPasskeyToken and account.updatePasskeyToken for passkey sign-inPasskey, PasskeyList, PasskeyChallenge and TokenSecret modelsFull Changelog: 27.0.0...27.1.0
Added: Analytics service, the Tracking helper and TrackingObserver, which were missing from 27.1.0-rc.5 through rc.7
Analytics service, the Tracking helper and TrackingObserver, which were missing from 27.1.0-rc.5 through rc.7Tracking takes the Analytics service and a property id instead of an emitter callbackenableAllAutoTracking() is now start()inactive without backgroundingFixed: host() reports the live connection state instead of always resolving open
host() reports the live connection state instead of always resolving openPush closed mid-connect now throws instead of silently proceedingFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/27.1.0-rc.4...27.1.0-rc.7
Added: Analytics.createEvent for sending tracking events
Analytics.createEvent for sending tracking eventsAnalyticsTracking for app-lifecycle and screenView events, and AnalyticsObserver for automatic route trackingAdded: background push notifications render the server notification title, body, and image
notification title, body, and imagerequestNotificationPermission() on the Push servicePOST_NOTIFICATIONS itself on first background subscribeFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/27.1.0-rc.2...27.1.0-rc.3
Added: Apps service to manage OAuth2 apps, keys, secrets, and installations
Apps service to manage OAuth2 apps, keys, secrets, and installationsOauth2 service for authorization, consent, device, PAR, and token flowsPush service for MQTT realtime push with iOS background deliveryTopic builder and a native android module for pushClient.setPushEndpoint() and Client.setPushClientId()Avatars.updatePhoto() and Avatars.deletePhoto() methodsApp, Oauth2*, and Account modelswebflow to the OAuthProvider enumFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/27.1.0-rc.1...27.1.0-rc.2
Added: Push service over MQTT with subscribe, setForeground and onOpen/onClose/onError, plus PushSubscription.update and unsubscribe
Push service over MQTT with subscribe, setForeground and onOpen/onClose/onError, plus PushSubscription.update and unsubscribeClient.setPushEndpoint and Client.setPushClientId to configure the push broker, and the Topic helper for building topicsAnalytics.createEvent for sending tracking eventsAnalyticsTracking for app-lifecycle events and screenView, and AnalyticsObserver for automatic route trackingApps service for apps, installations, keys, secrets and scopes, and Oauth2 service for authorize, token, device flow, grants and revokeAvatars.updatePhoto and Avatars.deletePhoto, and the Account modeltotal on Account.listSessions, the Locale.list* methods and listTransactions across the database servicescurrent on Account.deleteSessions, optional duration on Account.createEmailPasswordSession, and OAuthProvider.webflowmqtt5_client, flutter_background_service and flutter_local_notifications dependencies and an Android plugin; Android builds need core library desugaringInputFile(path:) instead of being rejected as emptyMap fieldsBreaking: removed Account.listLogs and the Log, LogList models
Account.listLogs and the Log, LogList modelsClient.setDevKeyX-Appwrite-Response-Format: 2.3.0)Account.createIdTokenSession for native Apple and Google sign-in with IdTokenProvider enumAccount.createRecoveryOTP and Account.updateRecoveryOTP for code-based password recoveryAccount.createEmailVerificationOTP and Account.updateEmailVerificationOTPkakao and tiktok values to OAuthProviderpasswordPwned field on User and providerIdToken field on IdentityFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/26.2.0...27.0.0
Added: DocumentsDB and VectorsDB services for document and vector database access
DocumentsDB and VectorsDB services for document and vector database accessuserId, emailHash and name parameters to Avatars.getPhoto()cloudflare and resend values to OAuthProvider enumauto value to ImageGravity enumX-Appwrite-Response-Format header to 2.0.0Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/26.1.0...26.2.0
feat: deliver realtime errors to subscription streams (v26.1.0) by @ArnabChatterjee20k in https://github.com/appwrite/sdk-for-flutter/pull/330
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/26.0.0...26.1.0
Breaking: Execution.functionId replaced by resourceId and resourceType, now that executions cover both functions and sites
Execution.functionId replaced by resourceId and resourceType, now that executions cover both functions and sitesavatars.getPhoto returning the user's best available profile photohuggingface OAuth providercustom authentication factorExecutionResourceType enum and resourceType attribute on the Execution modelFormatExceptiondevice_info_plus to <14.0.0 and package_info_plus to <11.0.0Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/25.4.0...26.0.0
Added: Organization service for managing app installations
Organization service for managing app installationsTeams servicelistConsents, getConsent, deleteConsentlistConsentTokens, getConsentToken, deleteConsentTokenfolder parameter to storage.createFile, and folder and key to FileFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/25.3.0...25.4.0
Added: Client.setBearer() method for OAuth access token authentication
Client.setBearer() method for OAuth access token authenticationQuery.vectorDot, Query.vectorCosine, Query.vectorEuclidean vector similarity query methodsappwrite value to OAuthProvider enumLocale model fields: city, timeZone, postalCode, latitude, longitude, ISP and connection detailsLog model docs now include hidden user typeFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/25.2.0...25.3.0
Added: Realtime connections now authenticate with the configured JWT.
impersonateUserId on avatars and storage file requests.Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/25.1.0...25.2.0
Added: Email metadata fields to User (emailCanonical, emailIsFree, emailIsDisposable, emailIsCorporate, emailIsCanonical).
User (emailCanonical, emailIsFree, emailIsDisposable, emailIsCorporate, emailIsCanonical).Membership.userAccessedAt field.accept header matching each endpoint's response type.Client.call() no longer sends the x-appwrite-project header by default.Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/25.0.0...25.1.0
Breaking: avatars.getScreenshot theme parameter now uses the BrowserTheme enum
avatars.getScreenshot theme parameter now uses the BrowserTheme enumpresences service methodsBrowserTheme enumPresence model is now concrete and adds a metadata fieldFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/24.2.0...25.0.0
feat: support concurrent chunk uploads by @TorstenDittmann in https://github.com/appwrite/sdk-for-flutter/pull/314
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/24.1.1...24.2.0
Fixed: Removed Advisor service and Insight, InsightCTA, InsightList, Report, ReportList models (admin-only endpoints, not intended for client SDKs)
Advisor service and Insight, InsightCTA, InsightList, Report, ReportList models (admin-only endpoints, not intended for client SDKs)sizeActual field to File modelFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/24.1.0...24.1.1
Added: Realtime presences channel and RealtimePresence types for presence subscriptions
presences channel and RealtimePresence types for presence subscriptionsAdvisor and Presences servicesInsight, Presence, and Report models with list variantsfusionauth, keycloak, and kick providers to OAuthProvider enumX-Appwrite-Response-Format header to 1.9.5Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/24.0.0...24.1.0
Breaking: Added unsubscribe(), update(), and close() to Realtime subscriptions
unsubscribe(), update(), and close() to Realtime subscriptionsuserPhone field to Membership modelX-Appwrite-Response-Format header to 1.9.2Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/23.1.0...24.0.0
Added x OAuth provider to OAuthProvider enum
x OAuth provider to OAuthProvider enumuserType field to Log modelgetHeaders() method to ClientX-Appwrite-Response-Format header to 1.9.1Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/23.0.0...23.1.0
[BREAKING] Changed $sequence type from int to String for Row and Document models
$sequence type from int to String for Row and Document modelssetImpersonateUserId(), setImpersonateUserEmail(), setImpersonateUserPhone() on Client, ClientBrowser, and ClientIOimpersonator and impersonatorUserId optional fields to User modelLog model field descriptions to clarify impersonation behavior for userId, userEmail, userNameX-Appwrite-Response-Format header to 1.9.01.9.x and dependency example to ^23.0.0Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/22.0.0...23.0.0
Breaking: Channel API no longer defaults to '*'; explicit IDs required.
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/21.4.0...22.0.0
Added upsert() to DocumentChannel and RowChannel to support upsert operations on documents and rows.
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/21.3.0...21.4.0
## What's Changed Release version 21.3.0 Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/22.2.0...21.3.0
Release version 21.3.0
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/22.2.0...21.3.0
Add queries parameter to Realtime subscriptions for filtering events
queries parameter to Realtime subscriptions for filtering eventsRoles enum removed from Teams service; roles parameter now accepts List<String>Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/21.0.0...21.1.0
Breaking change: Output enum has been removed; use ImageFormat instead.
permissions: List<BrowserPermission>).Output enum has been removed; use ImageFormat instead.Channel helpers for Realtime.Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/20.3.3...21.0.0
feat: Flutter SDK update for version 20.3.2 by @ChiragAgg5k in https://github.com/appwrite/sdk-for-flutter/pull/290
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/20.3.2...20.3.3
Fix OAuth2 browser infinite redirect issue
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/20.3.1...20.3.2
Fix passing of null values and stripping only non-nullable optional parameters from the request body
null values and stripping only non-nullable optional parameters from the request bodyFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/20.3.0...20.3.1
null values and stripping only non-nullable optional parameters from the request bodygetScreenshot method to Avatars serviceTheme, Timezone and Output enumsAdd total parameter to list queries allowing skipping counting rows in a table for improved performance
total parameter to list queries allowing skipping counting rows in a table for improved performanceOperator class for atomic modification of rows via update, bulk update, upsert, and bulk upsert operationsFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/20.2.2...20.3.0
Widen device_info_plus and package_info_plus dependencies to allow for newer versions for Android 15+ support
device_info_plus and package_info_plus dependencies to allow for newer versions for Android 15+ supportCHUNK_SIZE constant to chunkSize@override annotation to toMap method in all model classesFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/20.2.1...20.2.2
Add transaction support for Databases and TablesDB
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/20.1.0...20.2.1
Deprecate createVerification method in Account service
createVerification method in Account servicecreateEmailVerification method in Account serviceFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/20.0.0...20.1.0
feat: Flutter SDK update for version 20.0.0 by @ChiragAgg5k in https://github.com/appwrite/sdk-for-flutter/pull/274, introduces support of enums in re
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/19.1.0...20.0.0
Add orderRandom query support by @abnegate in https://github.com/appwrite/sdk-for-flutter/pull/273
orderRandom query support by @abnegate in https://github.com/appwrite/sdk-for-flutter/pull/273Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/19.0.0...19.1.0
Rename CreditCard enum value unionChinaPay to unionPay
CreditCard enum value unionChinaPay to unionPayFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/18.0.0...19.0.0
Add 1.8.x support by @stnguyen90 in https://github.com/appwrite/sdk-for-flutter/pull/263
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/17.1.0...18.0.0
notContainsnotSearchnotBetweennotStartsWithnotEndsWithcreatedBeforecreatedAfterupdatedBeforeupdatedAfterupdateMagicURLSessionupdatePhoneSessionThe TablesDB service is the new recommended way to work with databases. Existing databases/collections/attributes/documents can be managed using the TablesDB service. Existing Databases service will continue to work, but new features may only be added to the TablesDB service.
Add incrementDocumentAttribute and decrementDocumentAttribute support to Databases service
incrementDocumentAttribute and decrementDocumentAttribute support to Databases servicegif support to ImageFormat enumsequence support to Document modelFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/17.0.2...17.1.0
Add gif support to ImageFormat enum
gif support to ImageFormat enumconvertTo() method in Document and Preferences models to correctly accept Map<String, dynamic>Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/17.0.1...17.0.2
Fix devKeys support by conditionally including credentials during requests by @ChiragAgg5k in https://github.com/appwrite/sdk-for-flutter/pull/254
devKeys support by conditionally including credentials during requests by @ChiragAgg5k in https://github.com/appwrite/sdk-for-flutter/pull/254Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/17.0.0...17.0.1
Update flutter_web_auth_2 dependency to version 4.1.0
flutter_web_auth_2 dependency to version 4.1.0auth.html example in README.md to align with flutter_web_auth_2 documentationflutter_web_auth_2 version 4.1.0Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/16.1.0...17.0.0
chore: add setDevKey and upsertDocument methods by @ChiragAgg5k in https://github.com/appwrite/sdk-for-flutter/pull/251
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/16.0.0...16.1.0
setDevKey method to Client serviceupsertDocument method to Databases serviceAdd to doc examples due to the new multi region endpoints
<REGION> to doc examples due to the new multi region endpointsGif from ImageFormat enumsearch param from listExecutions methodtoken param to getFilePreview and getFileView for File tokens usageFull Changelog: https://github.com/appwrite/sdk-for-flutter/compare/15.0.2...16.0.0
Gif from ImageFormat enumsearch param from listExecutions methodtoken param to getFilePreview and getFileView for File tokens usagequality for getFilePreview from 0 to -1Only updates user-agent if set to prevent CORS errors on Flutter web
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/15.0.1...15.0.2
User-Agent header and only encode it when present.https://<REGION>.cloud.appwrite.io/v1.fix: remove content-type from GET requests by @loks0n in https://github.com/appwrite/sdk-for-flutter/pull/245
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/15.0.0...15.0.1
Content-Type header from GET and HEAD requests.setEndpoint and setEndPointRealtime methods.Encode user-agents properly to fix issue - https://github.com/appwrite/sdk-for-dart/issues/74 .
AppwriteException's response parameter from a dynamic object to an optional string (?String).Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/14.0.0...15.0.0
User-Agent header to fix invalid HTTP header field value error.AppwriteException's response parameter from a dynamic object to an optional string (?String).fix: pong response & chunked upload by @loks0n in https://github.com/appwrite/sdk-for-flutter/pull/237
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/13.1.1...14.0.0
chunkedUpload method.Fix for realtime subscriptions by @abnegate in https://github.com/appwrite/sdk-for-flutter/pull/196
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/12.0.1...14.0.0-rc1
fix: type errors by @loks0n in https://github.com/appwrite/sdk-for-flutter/pull/228
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/13.1.0...13.1.1
release: sdk by @loks0n in https://github.com/appwrite/sdk-for-flutter/pull/223
Full Changelog: https://github.com/appwrite/sdk-for-flutter/compare/13.0.0...13.1.0
One column per quarter.