---
schema_version: "1"
id: 1ad1278e70438abfa60c0cffc619014bf832c43fa089ae86eff334d49f19c932
title: Add the Service SDK Frameworks with CocoaPods
collection: developer
version: current
locale: en-us
portal_url: https://docs.salesforce.com/developer/current/en-us/service-cloud/service-sdk-ios/guides/ios-install-sdk-cocoapods.md
canonical_url: https://developer.salesforce.com/docs/service/service-sdk-ios/guide/ios-install-sdk-cocoapods.html
source_site: developer.salesforce.com
content_type: documentation
content_hash: c12ec1f4ddbf10add7e083c526218bee093462a5e9272128efadfae2f420bb54
products:
  - Embedded Service Chat SDK for iOS Developer Guide
  - Service Cloud Developer Content
---

# Add the Service SDK Frameworks with CocoaPods

Add the SDK frameworks using CocoaPods, a developer tool that automatically manages dependencies.

**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).

1.  If you haven't already done so, install the [CocoaPods](https://cocoapods.org/) gem and initialize the CocoaPods main repository.

    ```java
    sudo gem install cocoapods
    pod setup
    ```

    **note:** The minimum supported version of CocoaPods is 1.0.1. If you're not sure what version you have, use `pod --version` to check the version number.

2.  If you already have [CocoaPods](https://cocoapods.org/) installed, update your pods to the latest version.

    ```java
    pod update
    ```

3.  Change to the root directory of your application project.

4.  Create or edit a file named `Podfile` that contains the Service Chat SDK dependency.

    1.  If you want to install the complete _Service Chat SDK_, update your `Podfile` to include `ServiceSDK`.

        ```java
        source 'https://github.com/CocoaPods/Specs.git'
        source 'https://github.com/goinstant/pods-specs-public'

        # To use the SDK (with all components)
        target '<your app target>' do
            pod 'ServiceSDK'
        end
        ```

    2.  If you want to install a single _Service Chat SDK_ component, create a similar `Podfile` to the one specified above, but only include the desired pod.

        | Feature | Pod name          |
        | ------- | ----------------- |
        | Chat    | `ServiceSDK/Chat` |

        For example, the following `Podfile` installs Chat.

        ```java
        source 'https://github.com/CocoaPods/Specs.git'
        source 'https://github.com/goinstant/pods-specs-public'

        # To use Chat
        target '<your app target>' do
            pod 'ServiceSDK/Chat'
        end
        ```

        If you don't specify a version number, you automatically get the latest version of that component. If you want to add a specific version to your component, be sure to add the version number of the Service Chat SDK and _not_ the version number of the individual component.

5.  Run the CocoaPods installer.

    ```java
    pod install
    ```

    This command generates a `.xcworkspace` file for you with all the dependencies included.

    **note:** If you run into issues installing or updating the SDK, clear the local CocoaPods cache and then perform a `pod update`.

6.  Open the `.xcworkspace` file that CocoaPods generated and continue with the installation process.

    **note:** Be sure to open the `.xcworkspace` file (which includes all the dependencies) and _not_ the `.xcodeproj` file.

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