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

# iOS

> On this page, you will find an overview of all relevant changes to the Social Plus UIKit 

<Note>
  **Xcode forward compatibility restored in UIKit 4.19.0**

  The Xcode 26 compatibility issue caused by **RealmSwift** binaries has been fully resolved in **UIKit 4.19.0**. The UIKit now integrates with **AmitySDK v8.0.0**, which has migrated its cache layer from Realm to Core Data. Realm and RealmSwift are no longer required, and Xcode forward compatibility is fully restored. We recommend upgrading to 4.19.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 installation changes, including UIKit-specific steps.
</Note>

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

  #### For You Feed

  Added the personalized **For You** feed, gated by the network's For You feed configuration.

  #### Event Shareable Links

  Added shareable event links to the event detail experience.

  ## 🚨 Compatibility Changes

  * Removed the deprecated v3 modules.

  ## 🐞 Bug Fixes

  * Fixed clickable links not working on posts.
  * Fixed read-only livestreams for guests and non-members.
  * Fixed the toast type and icon.
  * Fixed a moderator being unable to delete an event.
  * Fixed co-host name display and layout.

  ## 🧩 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 |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 8.3.0   |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="4.22.2  (19/06/2026)" tags={["Improvements"]}>
  ## 🚀 New Features

  * Support avatar rendering from custom avatar URL(`avatarCustomUrl`)

  ## 🐞 Bug Fixes

  * Fixed the poll "see results / see more options" label color and standardized the vote button styling on the poll post view.

  ## 🧩 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 |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 8.2.1   |
    </Accordion>
  </AccordionGroup>
</Update>

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

  * Fixed permission check before showing the add button on the community membership page.
  * Fixed members list not refreshing immediately after a member is added or removed.
  * Fixed follow button text on the user profile page.
  * Fixed clip action behavior callback not being triggered when tapping the clip feed.
  * Added element IDs for events and clips in the newsfeed, and for creation buttons on the community and user profile pages.

  ## 🚨 Compatibility Changes

  * Deprecated `AmityLivestreamBehavior`.
  * Deprecated `goToCreateCommunityPage(context:)` on `AmitySocialHomeTopNavigationComponentBehavior`.

  ## 🧩 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 |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 8.2.1   |
    </Accordion>
  </AccordionGroup>
</Update>

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

  * Fixed permission check before showing the add button on the community membership page.
  * Fixed members list not refreshing immediately after a member is added or removed.
  * Fixed dark theme colors in the notification tray.
  * Fixed follow button text on the user profile page.
  * Fixed clip action behavior not being triggered when tapping the clip feed.
  * Added element IDs for events and clips in the newsfeed, and for creation buttons on the community and user profile pages.

  ## 🚨 Compatibility Changes

  * Deprecated `AmityLivestreamBehavior`.
  * Deprecated `goToCreateCommunityPage(context:)` on `AmitySocialHomeTopNavigationComponentBehavior`.

  ## 🧩 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 |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 8.2.1   |
    </Accordion>
  </AccordionGroup>
</Update>

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

  #### Visitor Usage Limit Page

  Added `AmityVisitorUsageLimitPage` , a full-screen error shown when a visitor exceeds their daily read quota. Two new `AmityGlobalBehavior` overrides let you customise the experience:

  * `handleVisitorUsageLimitReached()` — replace the default full-page error with your own UI
  * `handleVisitorUsageLimitSignIn()` — replace the default sign-in toast with navigation to your own sign-in screen

  ## 🧩 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 |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 8.2.0   |
    </Accordion>
  </AccordionGroup>
</Update>

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

  * Fixed analytic data sync issue in the underlying 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 |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 8.1.3   |
    </Accordion>
  </AccordionGroup>
</Update>

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

  * Fixed stale session data issue after secure logout in the underlying 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 |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 8.1.2   |
    </Accordion>
  </AccordionGroup>
</Update>

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

  #### Localization in Social Features

  All UI strings are now externalised into string resource files, enabling custom translations and runtime language switching. Developers can add any language by providing translated resource files without modifying application code. See the [Localization guide](/uikit/customization/localization) for setup instructions and platform-specific details.

  ## 🐞 Bug Fixes

  * Fixed post mentioned user 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 |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 8.1.1   |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="4.20.0 (08/05/2026)" tags={["New Releases"]}>
  ## 🚀 New Features

  #### Integrated with AmitySDK v8.1.0

  UIKit now integrates with **AmitySDK v8.1.0**.

  ## 🧩 Compatibility

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

    <Accordion title="Dependencies" icon="book">
      | Library                | Version |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 8.1.0   |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="4.19.0 (24/04/2026)" tags={["New Releases"]}>
  ## 🚀 New Features

  #### Migrated to AmitySDK v8.0.0 — Realm Removed

  UIKit now integrates with **AmitySDK v8.0.0**. The Realm and RealmSwift dependency has been removed — `Realm.xcframework` and `RealmSwift.xcframework` are no longer installed through the `SharedFrameworks` Package.swift file. No public UIKit APIs have changed; only the installation steps differ.

  See the [iOS SDK v8 Migration Guide](/social-plus-sdk/changelogs/ios-sdk-v8-migration-guide) for updated installation instructions.

  ## 🧩 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 |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 8.0.0   |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="4.18.3-xcode26.4.1 (24/04/2026)" tags={["New Releases","Improvements"]}>
  ## 🚀 New Features

  #### Bluetooth Remote & Hardware Key Support for Livestream Start

  Pressing a paired Bluetooth remote shutter or the device's hardware volume key now starts a livestream, consistent with how these controls trigger the camera shutter in the native camera app.

  ## 🐞 Bug Fixes

  * Fixed a crash in `AmityNewsfeedComponent`.

  #### Specific Xcode support

  26.4.1 => 4.18.3-xcode26.4.1 26.4 => 4.18.3-xcode26.4 26.3 => 4.18.3-xcode26.3

  ## 🧩 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 |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 7.19.1  |
      | Realm                  | 20.0.3  |
      | Realm Swift            | 20.0.3  |
    </Accordion>
  </AccordionGroup>
</Update>

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

  #### Product Tag Click Handlers in Global Behavior

  Add `onPostProductTagClick(context:)` and `onLivestreamProductTagClick(context:)` callbacks in `AmityGlobalBehavior`, enabling custom handling of product tag interactions in posts and livestreams.

  #### External Bundle Icon Support in Config File

  Config file now supports loading icons from an external bundle, allowing greater flexibility for custom icon assets.

  #### Specific Xcode support

  26.4 => 4.18.1

  26.3 => 4.18.1-xcode26.3

  ## 🧩 Compatibility

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

    <Accordion title="Dependencies" icon="book">
      | Library                | Version |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 7.19.0  |
      | Realm                  | 20.0.3  |
      | Realm Swift            | 20.0.3  |
    </Accordion>
  </AccordionGroup>
</Update>

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

  #### Multi-Level Reply Rendering

  Add multi-level reply rendering with optimistic reply support.

  #### Expand Replies with Load More

  Add expand replies with load more support.

  #### URL/Hyperlink Text in Comments

  Add URL/hyperlink text support in comments.

  #### Portrait Livestream Thumbnail Placeholder

  Add portrait livestream thumbnail placeholder.

  #### Specific Xcode support

  26.4 => 4.18.0

  26.3 => 4.18.0-xcode26.3

  26.2 => 4.18.0-xcode26.2

  ## 🐞 Bug Fixes

  * Fixed various UI bugs.

  ## 🧩 Compatibility

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

    <Accordion title="Dependencies" icon="book">
      | Library                | Version |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 7.19.0  |
      | Realm                  | 20.0.3  |
      | Realm Swift            | 20.0.3  |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="4.17.0-beta05 (24/03/2026)" tags={["New Releases"]}>
  ## 🚀 New Features

  #### Product Tagging in Posts

  Support product tagging in post composer — tag products via `@` text mention or per-media tag button with up to 20 products per post. Tagged products display as a list below post content.

  #### Livestream Product Tagging

  Support product management in livestreams — hosts and co-hosts can tag, pin, and remove products during broadcasts. Viewers browse tagged products via a scrollable overlay with real-time pinned product display.

  #### Specific Xcode support

  26.3 => 4.17.0-beta05

  16.x => 4.17.0-beta05-xcode16.4

  26.2 => 4.17.0-beta05-xcode26.2

  ## 🧩 Compatibility

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

    <Accordion title="Dependencies" icon="book">
      | Library                | Version |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 7.13.0  |
      | Realm                  | 10.54.6 |
      | Realm Swift            | 10.54.6 |
    </Accordion>
  </AccordionGroup>
</Update>

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

  * Fixed poll options failed to expand.

  #### Specific Xcode support

  26.3 => 4.16.6

  ## 🧩 Compatibility

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

    <Accordion title="Dependencies" icon="book">
      | Library                | Version |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 7.13.0  |
      | Realm                  | 10.54.6 |
      | Realm Swift            | 10.54.6 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="4.17.0-beta03 (09/02/2026)" tags={["New Releases, Improvements"]}>
  ## 🚀 New Features

  #### Support External Config File

  * Introduced `AmityUIKit4Manager.setConfigFile(filePath: String)` to be able to load config file from application level.

  ## 🐞 Bug Fixes

  * Fixed incorrect camera exporsure on Story creation.

  #### Specific Xcode support

  26.2 => 4.17.0-beta03

  16.x => 4.17.0-beta03-xcode16.4

  26.1 => 4.17.0-beta03-xcode26.1

  26.3 => 4.17.0-beta03-xcode26.4

  ## 🧩 Compatibility

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

    <Accordion title="Dependencies" icon="book">
      | Library                | Version |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 7.13.0  |
      | Realm                  | 10.54.6 |
      | Realm Swift            | 10.54.6 |
    </Accordion>
  </AccordionGroup>
</Update>

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

  #### Livestream analytics

  Viewers watching sessions are captured automatically on UIKit

  #### Specific Xcode support

  26.2 => 4.17.0-beta02

  16.x => 4.17.0-beta02-xcode16.4

  26.1 => 4.17.0-beta02-xcode26.1

  ## 🧩 Compatibility

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

    <Accordion title="Dependencies" icon="book">
      | Library                | Version |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 7.13.0  |
      | Realm                  | 10.54.6 |
      | Realm Swift            | 10.54.6 |
    </Accordion>
  </AccordionGroup>
</Update>

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

  #### Event Scheduling

  Introduce Event scheduling with functionalities such as RSVP, reminders, discussion, and livestreaming

  #### Co-Streaming

  Introduce an ability to invite a viewer to co-stream a livestream session for livestram in communities

  #### Specific Xcode support

  26.1 => 4.17.0-beta01

  16.x => 4.17.0-beta01-xcode16.4

  26.2 => 4.17.0-beta01-xcode26.2

  ## 🧩 Compatibility

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

    <Accordion title="Dependencies" icon="book">
      | Library                | Version |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 7.13.0  |
      | Realm                  | 10.54.6 |
      | Realm Swift            | 10.54.6 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="4.16.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 | 14.0    |
      | Xcode          | 26.1    |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library                | Version |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 7.13.0  |
      | Realm                  | 10.54.6 |
      | Realm Swift            | 10.54.6 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="4.15.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 | 14.0    |
      | Xcode          | 26.0    |
    </Accordion>

    <Accordion title="Dependencies" icon="book">
      | Library                | Version |
      | :--------------------- | :------ |
      | Amity-Social-Cloud-SDK | 7.12.0  |
      | Realm                  | 10.54.6 |
      | Realm Swift            | 10.54.6 |
    </Accordion>
  </AccordionGroup>
</Update>

<Update label="4.14.0  (17/10/2025)" tags={["New Releases","Improvements"]}>
  ## 🚀 New Features

  #### Post structure compatibility

  * Ensure UIKit only query for posts that can be rendered.

  ## 🧩 Compatibility

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

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

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

  #### Public Access

  * Support visitor access.

  ## 🧩 Compatibility

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

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

<Update label="4.12.0  (11/09/2025)" tags={["New Releases"]}>
  ## 🚀 New Features

  #### Image Poll Post

  * Poll post now support having images as options.
  * Add an ability update poll answer.

  #### Post title

  * Post can now be created with an optinal title.

  #### Hashtag

  * Add hashtag support on Post.
  * Enable Post search by hashtag.

  #### Reaction Options

  * Add Multiple reaction options support.

  ## 🧩 Compatibility

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

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

<Update label="4.11.0  (18/07/2025)" tags={["New Releases"]}>
  ## 🚀 New Features

  #### Livestream chat & reactions

  * Introduce an ability to chat in a community's livestream.
  * Introduce an ability to send reaction in a community's livestream.

  #### Clip post

  * Introduce an ability create and view a clip post (vertically scrolling video).

  ## 🧩 Compatibility

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

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