Skip to main content

Documentation Index

Fetch the complete documentation index at: https://learn.social.plus/llms.txt

Use this file to discover all available pages before exploring further.

Xcode forward compatibility restored in SDK 8.0.0The Xcode 26 compatibility issue caused by RealmSwift binaries has been fully resolved in SDK 8.0.0. The cache layer has been migrated from Realm to Core Data, eliminating the Realm dependency entirely and restoring forward compatibility across Xcode versions. We recommend upgrading to 8.0.0 or later to remove any Xcode version constraints from your project.See the iOS SDK v8 Migration Guide for full upgrade instructions.
​
8.0.0 (24/04/2026)
New Releases

​
🚀 New Features

​
Core Data-Powered Cache Layer

Migrate the SDK’s local cache from Realm to Core Data, eliminating the Realm and RealmSwift dependencies. This fully restores Xcode forward compatibility — no more per-Xcode-version SDK variants are required.

​
🚨 Breaking Changes

​
Realm Dependency Removed

Realm and RealmSwift are no longer bundled with or required by the SDK. Remove these libraries from your project’s dependencies when upgrading to 8.0.0.See the iOS SDK v8 Migration Guide for a full list of breaking changes, renamed APIs, and upgrade steps.

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode26.4.1+
LibraryVersion
Alamofire5.7.1
CocoaAsyncSocket7.6.5 - Hash: 2129f84
CocoaMQTT3.1.1 - Hash: 2731e27
Starscream3.1.1
​
7.19.1 (24/04/2026)
New ReleasesImprovements

​
🚀 New Features

​
Auto-Retry for MQTT Topic Subscriptions

Add an automatic retry mechanism for MQTT topic subscriptions, improving connection resilience when subscriptions fail due to transient network issues.

​
🐞 Bug Fixes

  • Fixed AmityCollection for posts emitting redundant updates when the underlying data had not changed.

​
Specific Xcode support

26.4 => 7.19.126.4.1 => 7.19.1-xcode26.4.126.3 => 7.19.1-xcode26.326.2 => 7.19.1-xcode26.2

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode26.4
LibraryVersion
Alamofire5.7.1
CocoaAsyncSocket7.6.5 - Hash: 2129f84
CocoaMQTT3.1.1 - Hash: 2731e27
Realm20.0.3
Realm Swift20.0.3
Starscream3.1.1
​
7.19.0 (27/03/2026)
New Releases

​
🚀 New Features

​
Live Thumbnail and Resolution in AmityRoom

Add liveThumbnailUrl and resolution fields to AmityRoom to expose server-generated thumbnail and stream resolution data.Add link detection support to comment create/update APIs, enabling automatic link parsing in comment text.

​
Root Comment and Latest Comment ID in Query

Add rootId and latestCommentId fields to the comment query API for improved comment threading and navigation.

​
Page Size for Get Comments

Add pageSize parameter to getComments API for more granular control over comment pagination.

​
Specific Xcode support

26.4 => 7.19.026.3=> 7.19.0-xcode26.326.2 => 7.19.0-xcode26.2

​
🐞 Bug Fixes

  • Fixed LiveCollection observation not being removed when an error occurs on loading the next page.

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode26.4
LibraryVersion
Alamofire5.7.1
CocoaAsyncSocket7.6.5 - Hash: 2129f84
CocoaMQTT3.1.1 - Hash: 2731e27
Realm20.0.3
Realm Swift20.0.3
Starscream3.1.1
​
7.18.1 (23/03/2026)
New Releases

​
🚀 New Features

​
Product Tagging in Posts

Introduce AmityProduct and AmityProductTag models with product search API, enabling users to tag up to 20 products per post via text mentions and per-media tags. Supports creating and updating posts with product tags.

​
Livestream Product Tagging

Introduce product management APIs for livestream(Room) post — tag, pin, and remove products across all broadcast phases.

​
Specific Xcode support

26.3 => 7.18.116.x => 7.18.1-xcode16.426.2 => 7.18.1-xcode26.2

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode16.x - 26.2
LibraryVersion
Alamofire5.7.1
CocoaAsyncSocket7.6.5 - Hash: 2129f84
CocoaMQTT3.1.1 - Hash: 2731e27
Realm10.54.6
Realm Swift10.54.6
Starscream3.1.1
​
7.17.0 (27/02/2026)
New Releases

​
🚀 New Features

​
Get All Blocked Users

Introduce getAllBlockedUsers(completion:) on AmityUserRepository — returns the full list of blocked users (up to 100) as a non-paginated, one-shot async result with a 5-minute TTL cache.

​
Excluding Roles in Community Member Queries

Add excludingRoles parameter to getMembers() and searchMembers(). Members holding any of the specified roles are excluded from the live collection result.

​
Time-Bounded Post Pagination

Add untilAt parameter to getPosts, getCommunityFeed, and getUserFeed queries. When provided, the SDK stops fetching and collecting posts beyond the given datetime boundary.

​
Specific Xcode support

26.2 => 7.17.016.x => 7.17.0-xcode16.426.1 => 7.17.0-xcode26.1

26.3 => 7.17.0-xcode26.3

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode16.x - 26.2
LibraryVersion
Alamofire5.7.1
CocoaAsyncSocket7.6.5 - Hash: 2129f84
CocoaMQTT3.1.1 - Hash: 2731e27
Realm10.54.6
Realm Swift10.54.6
Starscream3.1.1
​
7.16.0 (13/02/2026)
New Releases

​
🚀 New Features

​
Thread Safety

All of CRUD API, AmityObject and AmityCollection API are now safe to be called from any actors.

​
Authentication

Introduce an ability to login with a pre-fetched accessToken.

​
Comment Count

Introduce a local calculated comment count based on incoming real-time events.

​
Community Post Query by Tags

Introduce an ability to community posts with matching tags.

​
Specific Xcode support

26.2 => 7.15.016.x => 7.15.0-xcode16.426.1 => 7.15.0-xcode26.1

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode16.x - 26.2
LibraryVersion
Alamofire5.7.1
CocoaAsyncSocket7.6.5 - Hash: 2129f84
CocoaMQTT3.1.1 - Hash: 2731e27
Realm10.54.6
Realm Swift10.54.6
Starscream3.1.1
​
7.14.1-beta4 (11/02/2026)
New Releases

​
🚀 New Features

​
Thread safety

  • Introduce two new static initializer method in AmityClient to initialize client safely in any thread
AmityClient.setup(apiKey: String, region: AmityRegion) async throws -> AmityClient
AmityClient.setup(apiKey: String, endpoint: AmityEndpoint) async throws -> AmityClient
  • Mark AmityClient as @unchecked Sendable

​
Specific Xcode support

26.2 => 7.14.1-beta416.x => 7.14.1-beta4-xcode16.426.1 => 7.14.1-beta4-xcode26.1

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode16.x - 26.2
LibraryVersion
Alamofire5.7.1
CocoaAsyncSocket7.6.5 - Hash: 2129f84
CocoaMQTT3.1.1 - Hash: 2731e27
Realm10.54.6
Realm Swift10.54.6
Starscream3.1.1
​
7.15.0 (30/01/2026)
New Releases

​
🚀 New Features

​
Livestream analytics

Introduce AmityRoomAnalytics for the purpose of tracking watch minute

​
Specific Xcode support

26.2 => 7.15.016.x => 7.15.0-xcode16.426.1 => 7.15.0-xcode26.1

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode16.x - 26.2
LibraryVersion
Alamofire5.7.1
CocoaAsyncSocket7.6.5 - Hash: 2129f84
CocoaMQTT3.1.1 - Hash: 2731e27
Realm10.54.6
Realm Swift10.54.6
Starscream3.1.1
​
7.14.1-beta3 (30/01/2026)
New Releases

​
🚀 New Features

​
Thread safety

  • Enable LiveObject/Collection to be initialized from any actors
  • Ensure thread safety on AmityClient props and functions.

​
Specific Xcode support

26.2 => 7.14.1-beta316.x => 7.14.1-beta3-xcode16.426.1 => 7.14.1-beta3-xcode26.1

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode16.x - 26.2
LibraryVersion
Alamofire5.7.1
CocoaAsyncSocket7.6.5 - Hash: 2129f84
CocoaMQTT3.1.1 - Hash: 2731e27
Realm10.54.6
Realm Swift10.54.6
Starscream3.1.1
​
7.14.1-beta2 (26/01/2026)
New Releases

​
🚀 New Features

​
Thread safety

  • Ensure thread safety on topic subscription.

​
Specific Xcode support

26.2 => 7.14.1-beta216.x => 7.14.1-beta2-xcode16.426.1 => 7.14.1-beta2-xcode26.1

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode16.x - 26.2
LibraryVersion
Alamofire5.7.1
CocoaAsyncSocket7.6.5 - Hash: 2129f84
CocoaMQTT3.1.1 - Hash: 2731e27
Realm10.54.6
Realm Swift10.54.6
Starscream3.1.1
​
7.14.1-beta1 (21/01/2026)
New Releases

​
🚀 New Features

​
Thread safety

  • Enable CRUD functions to called from any actors
  • Ensure public model(except AmityClient) properties are thread-safe.

​
Specific Xcode support

26.2 => 7.14.1-beta116.x => 7.14.1-beta1-xcode16.426.1 => 7.14.1-beta1-xcode26.1

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode16.x - 26.2
LibraryVersion
Alamofire5.7.1
CocoaAsyncSocket7.6.5 - Hash: 2129f84
CocoaMQTT3.1.1 - Hash: 2731e27
Realm10.54.6
Realm Swift10.54.6
Starscream3.1.1
​
7.14.0 (24/12/2025)
New Releases

​
🚀 New Features

​
Livestream Post with Room

Introduce Room service, an upgrade and a replacement forstream

​
Event

Introduce Event service, enabling event scheduling

​
Community Member Query

Introduce lastJoin sorting option

​
Specific Xcode support

26.1 => 7.14.016.x => 7.14.0-xcode16.426.2 => 7.14.0-xcode26.2

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode16.x - 26.2
LibraryVersion
Alamofire5.7.1
CocoaAsyncSocket7.6.5 - Hash: 2129f84
CocoaMQTT3.1.1 - Hash: 2731e27
Realm10.54.6
Realm Swift10.54.6
Starscream3.1.1
​
7.13.0 (10/11/2025)
New ReleasesImprovements

​
🚨 Compatibility Changes

​
Xcode 26.1 support

  • The binary is now built with Xcode 26.1, ensuring compatibility with Xcode 26.1 and later. The minimum toolchain version is now Xcode 26.1. Earlier Xcode versions are no longer supported.

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode26.1
LibraryVersion
Alamofire5.7.1
CocoaAsyncSocket7.6.5 - Hash: 2129f84
CocoaMQTT3.1.1 - Hash: 2731e27
Realm10.54.6
Realm Swift10.54.6
Starscream3.1.1
​
7.12.0 (28/10/2025)
New ReleasesImprovements

​
🚨 Compatibility Changes

​
Xcode 26 support

  • The binary is now built with Xcode 26, ensuring compatibility with Xcode 26 and later. The minimum toolchain version is now Xcode 26. Earlier Xcode versions are no longer supported.

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode26.0
LibraryVersion
Alamofire5.7.1
CocoaAsyncSocket7.6.5 - Hash: 2129f84
CocoaMQTT3.1.1 - Hash: 2731e27
Realm10.54.6
Realm Swift10.54.6
Starscream3.1.1
​
7.11.0 (17/10/2025)
New Releases

​
🚀 New Features

​
Mixed Attachments Post

  • Support mixed structure post where a post can contains multiple datatypes such as image, video, file, and audio.

​
Audio Content Support

  • Support audio file upload.
  • Introduce audio dataType for post.

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode16.0+
LibraryVersion
Realm10.54.5
Realm Swift10.54.5
​
7.10.0 (03/10/2025)
New Releases

​
🚀 New Features

​
Public Access

  • Added loginAsVisitor() function, enables user to interact as a visitor.

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode16.0+
LibraryVersion
Realm10.54.5
Realm Swift10.54.5
​
7.9.0 (11/09/2025)
New Releases

​
🚀 New Features

​
Child stream

  • Support child stream creation where a child stream can be linked to a parent stream.

​
Poll

  • Added unvotePoll() function, enables user to update poll answer.

​
Preview members

  • Added getPreviewMembers() on AmityChannel, enables access upto 4 members of converation and community channel.

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode16.0+
LibraryVersion
Realm10.54.5
Realm Swift10.54.5
​
7.8.0 (18/08/2025)
New Releases

​
🚀 New Features

​
PII detection

  • Added detected PII data to post, comment, and message.

​
Hashtag

  • Support adding hashtag to a post.
  • Support post search by hashtag.

​
User feed

  • Support new sources of posts on user feed. feedSources can be selected on user.

​
Post title

  • Support optional title on post creation.

​
🧩 Compatibility

ConfigVersion
Minimum Target13.0
Xcode16.0+
LibraryVersion
Realm10.49.3
Realm Swift10.49.3