> ## Documentation Index
> Fetch the complete documentation index at: https://social-b97141fb-feat-user-history-moderation-detail.mintlify.site/llms.txt
> Use this file to discover all available pages before exploring further.

# iOS

> This page contains an overview of all relevant changes made to the iOS SDK

<Note>
  **Xcode forward compatibility restored in SDK 8.0.0**

  The 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](/social-plus-sdk/changelogs/ios-sdk-v8-migration-guide) for full upgrade instructions.
</Note>

<Update label="8.8.0  (25/09/2026)" tags={["New Releases","Improvements"]}>
  ## 🚀 New Features

  #### Comment Approval for Communities

  A community can now require review before a new comment is visible. While a comment is pending, only its author, the community's reviewers, and network admins can see it. It stays out of public comment lists and comment counts until a reviewer approves it. See [Comment Review](/social-plus-sdk/social/content-management/comments/moderation/comment-review).

  * **Turn it on:** `AmityCommunityDataBuilder.setNeedApprovalOnCommentCreation(_:)` on create or update. Read it back with `AmityCommunity.isCommentReviewEnabled`.
  * **Approval status:** `AmityComment.approvalStatus` is an `AmityCommentApprovalStatus` (`pending`, `approved`, `rejected`).
  * **Create without a local copy:** `AmityCommentCreateOptions(isOptimistic: false)` skips the local comment, so the comment you get back carries the server's approval status. The default, `true`, keeps today's behavior.
  * **Review queue:** `AmityCommentRepository.getCommentReviewQueue(with:)` returns the community's pending comments as an `AmityCollection<AmityComment>`. Narrow it to one post or a date range with `AmityCommentReviewQueueQueryOptions`.
  * **Approve or decline:** `AmityCommentRepository.approveComment(withId:)` and `declineComment(withId:reason:)`. Declining deletes the comment. The optional `reason` (at most 250 characters) is kept for the moderation record only.
  * **Permission:** reviewers need `AmityPermission.reviewCommunityComment`.
  * **Editing while pending:** `AmitySocialSettings.isAllowEditCommentWhenReviewingEnabled` tells you whether an author may edit a pending comment.
  * **Realtime:** an approved comment appears as soon as it is approved, through the `comment.approved` event. A declined comment arrives as a deletion.

  #### Curated Content

  Fetch the posts selected for a topic configured in the Console, and build your own discovery surface around them. A pool is one bounded, ranked result with no pagination, and the SDK keeps the server's order. See [Topic-based Content Discovery](/social-plus-sdk/social/discovery-engagement/feed/curated-content).

  * **Fetch a pool:** `AmityCuratedContentRepository.getPool(topicId:limit:)` is an `async throws` call that returns an `AmityCuratedContentPool`. `limit` must be between 1 and 100.
  * **Analytics:** `AmityCuratedContentTopic.analytics` (`AmityCuratedContentAnalytics`) provides `markAsViewed()`, `markPostAsViewed(postId:)`, and `markPostClick(postId:)`.

  #### Pin Message in Live Channels

  Pin one message in a live channel so it stays visible above the chat. Pinning a new message replaces the current pin. The server clears the pin when the message is deleted or its author is banned from the channel or globally. See [Pin and Unpin Messages](/social-plus-sdk/chat/messaging-features/messages/pin-message).

  * **Pin and unpin:** `AmityMessageRepository.pinMessage(withId:)` and `unpinMessage(withId:)`.
  * **Read the pin:** `AmityChannel.pinnedMessage` holds the current pinned message, or `nil` when nothing is pinned.
  * **Permission:** `AmityPermission.pinMessage`. Channel moderators, and livestream hosts and co-hosts, have it by default. Channel role changes now update a member's permissions in real time, so a promoted or demoted member's pin permission changes immediately.
  * **Realtime:** the observed `AmityChannel` updates on every pin and unpin, driven by the `channel.messagePinned` and `channel.messageUnpinned` events.

  #### Typed Network Activity Observation

  Added `AmityClient.observeNetworkActivities(_:)`, a typed observer that supports multiple observers and replaces the previous single-slot callback. It returns a cancellable `AmityNetworkActivityToken` and delivers `AmityNetworkActivity` records for HTTP, upload, download, and MQTT traffic. Each record is labeled with an `AmityNetworkActivityType` and carries real timings and byte counts. The previous `observeNetworkActivities((URLRequest?, HTTPURLResponse?, Data?) -> Void)` overload is deprecated but still works.

  ## ✨ Improvements

  * Added `AmityPost.getLocalCommentCount(includePending:)`. By default, the count leaves out the current user's own comments that are still awaiting approval. Pass `true` to include them. `AmityPost.localCommentCount` is now deprecated and equals `getLocalCommentCount(includePending: true)`.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.8.0" icon="book-open" href="https://ios-sdk.docs.amity.co/8.8.0/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.7.0  (11/09/2026)" tags={["New Releases","Improvements"]}>
  ## 🚀 New Features

  #### Configurable Search Fields

  Added a search user type and a `searchBy` option to control which fields user search matches.

  #### Livestream Viewer Configuration

  Added livestream viewer configuration.

  #### v4 Sessions

  Updated the `loginWithAccessToken` API endpoint to use v4 sessions.

  ## 🐞 Bug Fixes

  * Fixed the avatar relationship not clearing when `avatarFileId` is emptied.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.7.0" icon="book-open" href="https://ios-sdk.docs.amity.co/8.7.0/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.6.0  (28/08/2026)" tags={["New Releases","Improvements"]}>
  ## 🚀 New Features

  #### Event Posts

  Added event-post support: an event shared to a community feed is delivered as a post (post `dataType` `event`), resolves through the event repository, and renders alongside regular posts.

  ## 🐞 Bug Fixes

  * Fixed a notification-tray seen-state issue.
  * Fixed staging regressions.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.6.0" icon="book-open" href="https://ios-sdk.docs.amity.co/8.6.0/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.5.4  (25/08/2026)" tags={["Improvements"]}>
  ## 🐞 Bug Fixes

  * Fixed permission values to match the backend.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.5.4" icon="book-open" href="https://ios-sdk.docs.amity.co/8.5.4/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.5.3  (18/08/2026)" tags={["Improvements"]}>
  ## 🐞 Bug Fixes

  * Fixed the query stream retaining objects that have left their context.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.5.3" icon="book-open" href="https://ios-sdk.docs.amity.co/8.5.3/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.5.2  (14/08/2026)" tags={["Improvements"]}>
  ## 🐞 Bug Fixes

  * Fixed the query stream reactor incorrectly processing items from a foreign entity.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.5.2" icon="book-open" href="https://ios-sdk.docs.amity.co/8.5.2/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.5.1  (07/08/2026)" tags={["Improvements"]}>
  ## 🐞 Bug Fixes

  * Fixed channel unread-count handling and channel data persistence.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.5.1" icon="book-open" href="https://ios-sdk.docs.amity.co/8.5.1/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.5.0  (31/07/2026)" tags={["New Releases","Improvements"]}>
  ## 🚀 New Features

  #### Report User

  Updated the report-user API to report a user profile with a reason.

  ## ✨ Improvements

  * Dropped the MQTT will message as part of the MQTT protocol alignment.

  ## 🐞 Bug Fixes

  * Fixed `getArchivedChannels()` to fetch and persist the channel list.
  * Fixed the sort order of the archived chats list.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.5.0" icon="book-open" href="https://ios-sdk.docs.amity.co/8.5.0/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.4.0  (16/07/2026)" tags={["Improvements"]}>
  ## 🐞 Bug Fixes

  * Fixed issues with channel archiving.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.4.0" icon="book-open" href="https://ios-sdk.docs.amity.co/8.4.0/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.3.0  (03/07/2026)" tags={["New Releases","Improvements"]}>
  ## 🚀 New Features

  #### For You Feed

  Added the personalized **For You** feed. Query it with `getForYouFeed()` and gate the surface on the network setting so the feed only renders when For You is enabled for the network.

  #### Bidirectional Block Visibility

  Added the reverse direction of the blocking model — the ability to read the users who have blocked the current user, alongside the existing blocked-user list.

  #### Shareable Link Configuration API

  Updated the shareable-link configuration API with a typed `AmitySharableContentType`, so links can be generated per content type (post, community, user, livestream, event) via `isEnabled(_:)` and `generateLink(_:referenceId:)`.

  ## 🐞 Bug Fixes

  * Fixed a message reaction bug.
  * Fixed event community being lost when the payload omits it.
  * Fixed a notification-tray item "seen" state issue.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.3.0" icon="book-open" href="https://ios-sdk.docs.amity.co/8.3.0/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.2.1  (12/06/2026)" tags={["Improvements"]}>
  ## 🐞 Bug Fixes

  * Fixed a SIGSEGV crash in `PostCommentCountEngine`.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.2.1" icon="book-open" href="https://ios-sdk.docs.amity.co/8.2.1/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.2.0  (05/06/2026)" tags={["New Releases","Improvements"]}>
  ## 🚀 New Features

  #### Community Tag Filtering

  Added `tags` parameter to `AmityCommunityQueryOptions`. Pass a list of tags to `getCommunities()` to narrow results to communities matching all specified tags.

  #### Visitor Daily Usage Limit

  Added detection for the visitor daily read quota (100 req/day, error code `400323`). When a visitor exceeds this limit, the SDK detects the error and emits an event via `AmityClient.getVisitorUsageLimitEvents() -> AnyPublisher<AmityVisitorUsageLimitEvent, Never>`.

  ## 🐞 Bug Fixes

  * Fixed event bus observation not being torn down during `AmityClient` initialization, causing stale observers.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.2.0" icon="book-open" href="https://ios-sdk.docs.amity.co/8.2.0/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.1.4  (29/05/2026)" tags={["Improvements"]}>
  ## 🐞 Bug Fixes

  * Fixed a crash when SDK APIs are called before `AmityClient` is set up.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.1.4" icon="book-open" href="https://ios-sdk.docs.amity.co/8.1.4/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.1.3  (27/05/2026)" tags={["Improvements"]}>
  ## 🐞 Bug Fixes

  * Fixed analytic data sync issue in the SDK.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.1.3" icon="book-open" href="https://ios-sdk.docs.amity.co/8.1.3/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.1.2  (27/05/2026)" tags={["Improvements"]}>
  ## 🐞 Bug Fixes

  * Fixed stale session data issue after secure logout.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.1.2" icon="book-open" href="https://ios-sdk.docs.amity.co/8.1.2/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.1.1  (15/05/2026)" tags={["Improvements"]}>
  ## 🐞 Bug Fixes

  * Fixed issue where `mentionees` value becomes empty when multiple posts contain the same mentioned user.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.4.1 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.1.1" icon="book-open" href="https://ios-sdk.docs.amity.co/8.1.1/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.1.0  (08/05/2026)" tags={["Improvements"]}>
  ## 🐞 Bug Fixes

  * Fixed issue where users couldn't RSVP to some events.
  * Made timestamp properties `createdAt` and `updatedAt` non-optional for some models.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 14.0 |
      | Xcode | 26.4.1 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.1.0" icon="book-open" href="https://ios-sdk.docs.amity.co/8.1.0/documentation/amitysdk/" horizontal />
</Update>

<Update label="8.0.0  (24/04/2026)" tags={["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](/social-plus-sdk/changelogs/ios-sdk-v8-migration-guide) for a full list of breaking changes, renamed APIs, and upgrade steps.

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 26.4.1+ |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>

  <Card title="📘 API Reference — 8.0.0" icon="book-open" href="https://ios-sdk.docs.amity.co/8.0.0/documentation/amitysdk/" horizontal />
</Update>

<Update label="7.19.1  (24/04/2026)" tags={["New Releases","Improvements"]}>
  ## 🚀 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.1

  26.4.1 => 7.19.1-xcode26.4.1

  26.3 => 7.19.1-xcode26.3

  26.2 => 7.19.1-xcode26.2

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 26.4 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Realm | 20.0.3 |
      | Realm Swift | 20.0.3 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.19.0  (27/03/2026)" tags={["New Releases"]}>
  ## 🚀 New Features

  #### Live Thumbnail and Resolution in AmityRoom

  Add `liveThumbnailUrl`, `liveResolution`, and `recordedResolution` fields to `AmityRoom` to expose server-generated thumbnail and stream resolution data.

  #### Link Detection in Comments

  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.0

  26.3=> 7.19.0-xcode26.3

  26.2 => 7.19.0-xcode26.2

  ## 🐞 Bug Fixes

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

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 26.4 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Realm | 20.0.3 |
      | Realm Swift | 20.0.3 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.18.1  (23/03/2026)" tags={["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.1

  16.x => 7.18.1-xcode16.4

  26.2 => 7.18.1-xcode26.2

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 16.x - 26.2 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Realm | 10.54.6 |
      | Realm Swift | 10.54.6 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.17.0  (27/02/2026)" tags={["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.0

  16.x => 7.17.0-xcode16.4

  26.1 => 7.17.0-xcode26.1\
  \
  26.3 => 7.17.0-xcode26.3

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 16.x - 26.2 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Realm | 10.54.6 |
      | Realm Swift | 10.54.6 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.16.0  (13/02/2026)" tags={["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.0

  16.x => 7.15.0-xcode16.4

  26.1 => 7.15.0-xcode26.1

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 16.x - 26.2 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Realm | 10.54.6 |
      | Realm Swift | 10.54.6 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.14.1-beta4  (11/02/2026)" tags={["New Releases"]}>
  ## 🚀 New Features

  #### Thread safety

  * Introduce two new static initializer method in AmityClient to initialize client safely in any thread

  ```text theme={null}
  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-beta4

  16.x => 7.14.1-beta4-xcode16.4

  26.1 => 7.14.1-beta4-xcode26.1

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 16.x - 26.2 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Realm | 10.54.6 |
      | Realm Swift | 10.54.6 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.15.0  (30/01/2026)" tags={["New Releases"]}>
  ## 🚀 New Features

  #### Livestream analytics

  Introduce `AmityRoomAnalytics` for the purpose of tracking watch minute

  #### Specific Xcode support

  26.2 => 7.15.0

  16.x => 7.15.0-xcode16.4

  26.1 => 7.15.0-xcode26.1

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 16.x - 26.2 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Realm | 10.54.6 |
      | Realm Swift | 10.54.6 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.14.1-beta3  (30/01/2026)" tags={["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-beta3

  16.x => 7.14.1-beta3-xcode16.4

  26.1 => 7.14.1-beta3-xcode26.1

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 16.x - 26.2 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Realm | 10.54.6 |
      | Realm Swift | 10.54.6 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.14.1-beta2  (26/01/2026)" tags={["New Releases"]}>
  ## 🚀 New Features

  #### Thread safety

  * Ensure thread safety on topic subscription.

  #### Specific Xcode support

  26.2 => 7.14.1-beta2

  16.x => 7.14.1-beta2-xcode16.4

  26.1 => 7.14.1-beta2-xcode26.1

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 16.x - 26.2 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Realm | 10.54.6 |
      | Realm Swift | 10.54.6 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.14.1-beta1  (21/01/2026)" tags={["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-beta1

  16.x => 7.14.1-beta1-xcode16.4

  26.1 => 7.14.1-beta1-xcode26.1

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 16.x - 26.2 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Realm | 10.54.6 |
      | Realm Swift | 10.54.6 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.14.0  (24/12/2025)" tags={["New Releases"]}>
  ## 🚀 New Features

  #### Livestream Post with Room

  Introduce Room service, an upgrade and a replacement for`stream`

  #### Event

  Introduce Event service, enabling event scheduling

  #### Community Member Query

  Introduce `lastJoin` sorting option

  #### Specific Xcode support

  26.1 => 7.14.0

  16.x => 7.14.0-xcode16.4

  26.2 => 7.14.0-xcode26.2

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 16.x - 26.2 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Realm | 10.54.6 |
      | Realm Swift | 10.54.6 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.13.0  (10/11/2025)" tags={["New Releases","Improvements"]}>
  ## 🚨 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

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 26.1 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Realm | 10.54.6 |
      | Realm Swift | 10.54.6 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.12.0  (28/10/2025)" tags={["New Releases","Improvements"]}>
  ## 🚨 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

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 26.0 |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Alamofire | 5.7.1 |
      | CocoaAsyncSocket | 7.6.5 - Hash: 2129f84 |
      | CocoaMQTT | 3.1.1 - Hash: 2731e27 |
      | Realm | 10.54.6 |
      | Realm Swift | 10.54.6 |
      | Starscream | 3.1.1 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.11.0  (17/10/2025)" tags={["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

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 16.0+ |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Realm | 10.54.5 |
      | Realm Swift | 10.54.5 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.10.0  (03/10/2025)" tags={["New Releases"]}>
  ## 🚀 New Features

  #### Public Access

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

  ## 🧩 Compatibility

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 16.0+ |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Realm | 10.54.5 |
      | Realm Swift | 10.54.5 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.9.0  (11/09/2025)" tags={["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

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 16.0+ |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Realm | 10.54.5 |
      | Realm Swift | 10.54.5 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="7.8.0  (18/08/2025)" tags={["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

  <AccordionGroup>
    <Accordion title="iOS SDK" icon="gear">
      | Config | Version |
      | :- | :- |
      | Minimum Target | 13.0 |
      | Xcode | 16.0+ |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library | Version |
      | :- | :- |
      | Realm | 10.49.3 |
      | Realm Swift | 10.49.3 |
    </Accordion>
  </AccordionGroup>
</Update>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.