# Add the Service SDK Frameworks Manually

Add the SDK frameworks by manually embedding the appropriate frameworks.

## Before You Begin

:::important
The legacy chat product is scheduled for retirement on February 14, 2026, and is in maintenance mode until then. During this phase, you can continue to use chat, but we no longer recommend that you implement new chat channels. To avoid service interruptions to your customers, migrate to [Messaging for In-App and Web](https://help.salesforce.com/s/articleView?id=service.miaw_intro_landing.htm\&type=5) before that date. Messaging offers many of the [chat features](https://help.salesforce.com/s/articleView?id=service.miaw_chat_vs_messaging.htm\&type=5) that you love plus asynchronous conversations that can be picked back up at any time. Learn about chat retirement in [Help](https://help.salesforce.com/s/articleView?id=001790618\&type=1).
:::

:::note
If you are using Xcode 12.3 or later, you must install the SDK using XCFramework files.
:::

1. Download the SDK frameworks from the [Service Chat SDK download page](https://github.com/forcedotcom/ServiceSDK-iOS/wiki/Get-the-iOS-SDK).

2. Embed the relevant Service Chat SDK frameworks into your project.

   You can find the framework files within the `Frameworks` folder. Specifically, the following frameworks are available for you to use:

   | Framework     | Description                                                 |
   | ------------- | ----------------------------------------------------------- |
   | `ServiceCore` | Contains all the common components used by the Service SDK. |
   | `ServiceChat` | Contains access to the Chat features of the SDK.            |

   Add the relevant frameworks to the **Frameworks, Libraries, and Embedded Content** section of the **General** tab for your target app.

   :::important
   Before embedding a framework into your project, be sure to copy the framework file into your project folder (or another location found in the framework search path). If Xcode can’t find the framework, you won’t be able to access its contents in your code.
   :::

Once you've added the SDK frameworks, proceed with [the installation instructions](/docs/service/service-sdk-ios/guide/ios-sdk-install-overview.md).