Guides / Building Search UI

How to install InstantSearch iOS

As of May 1st, 2024, Apple requires all iOS apps to include a privacy manifest. Ensure you incorporate our provided privacy manifest files into your documentation. For more details, see Privacy Manifest.

Installing InstantSearch iOS

To confirm the latest version of InstantSearch iOS, please refer to our list of releases.

You can add InstantSearch iOS to your project using either Swift Package Manager, Cocoapods, or Carthage.

Swift Package Manager

The Swift Package Manager (SPM) is a tool to manage the distribution of Swift code. It’s integrated with the Swift build system to automate the process of downloading, compiling, and linking dependencies. Since the release of Swift 5 and Xcode 11, SPM is compatible with the iOS, macOS and tvOS build systems for creating apps.

To use SPM, you should use Xcode 11 to open your project. Click File -> Swift Packages -> Add Package Dependency, and enter the URL of the InstantSearch repository ( If you consider to use only the business logic modules of InstantSearch, and don’t need the set of provided UIKit controllers in your project, you only have to select InstantSearchCore in the list of products that show up.

If you’re a framework author and use InstantSearch as a dependency, update your Package.swift file:

let package = Package(
    // 7.1.0 ..< 8.0.0
    dependencies: [
        .package(url: "", from: "7.1.0")


CocoaPods is a dependency manager for Cocoa projects.

  • If you don’t have CocoaPods installed on your machine, open your terminal and run sudo gem install cocoapods.
  • If you don’t have a Podfile in your project, type pod init. A Podfile will be created for you.
  • Open your Podfile and add

To install InstantSearch, simply add the following line to your Podfile:

pod 'InstantSearch', '~> 7.1'
# pod 'InstantSearch/Core' for access to everything except the UI controllers
  • On your terminal, run pod update.


Carthage is a simple, decentralized dependency manager for Cocoa.

To install InstantSearch, add the following line to your Cartfile:

github "algolia/instantsearch-ios" ~> 7.1

Launch the following commands from the project directory:

carthage update
carthage build

Carthage doesn’t provide a way to build only specific subcomponents (equivalent to CocoaPods’s subspecs) of a repository. It builds all components and their dependencies with the above commands. However, you don’t need to copy frameworks you aren’t using into your project. For instance, if you don’t use the UI components from InstantSearch, you can delete all InstantSearch frameworks except InstantSearchCore from the Carthage build directory.

Did you find this page helpful?