countly-sdk-ios is the open-source Objective-C client library that adds Countly analytics, crash reporting and push notifications to iOS, watchOS, tvOS and macOS applications, and it is intended for mobile and desktop developers whose data lands in a Countly Lite or Countly Enterprise server.
What it is
countly-sdk-ios is the Apple-platform SDK published by Countly. It is integrated into iOS, watchOS, tvOS and macOS applications and reports to Countly, a product analytics solution that tracks product performance and customer journey and behavior across mobile, web and desktop applications. The repository holds the SDK source written in Objective-C, released under the MIT licence, with 627 stars and 240 forks on GitHub and two open issues as of the last push on 10 September 2026.
The concrete problem it solves is instrumentation. Instead of building an event pipeline, crash capture, push delivery and survey plumbing per platform, a team adds one SDK and gains those features against a Countly backend it already operates. It replaces the hand-rolled analytics layer an Apple developer would otherwise write, and it removes the need to maintain separate instrumentation for each Apple platform, because a single SDK covers iOS, watchOS, tvOS and macOS.
Key capabilities
- Analytics for tracking product and user behavior against the Countly backend.
- Push Notifications delivered to Apple devices from Countly.
- User Profiles that store per-user attributes alongside tracked events.
- Crash Reports capturing crashes and errors, matching the repository's
crash-dump and crash-reporting topics.
- A/B Testing for running and measuring experiments inside the application.
- Performance Monitoring that records application performance next to analytics data.
- Feedback Widgets collecting surveys, NPS and ratings in-app.
Who uses it and how
- Mobile product teams instrumenting an iOS application and sending events, sessions and user profiles to Countly for product analytics reporting.
- Teams shipping across phone, watch, TV and desktop, who need one SDK rather than four because the product runs on iOS, watchOS, tvOS and macOS.
- Operations that run Countly themselves: the README points to the Countly Lite repository for the server, so the SDK pairs with a self-hosted or licensed Countly deployment.
- Teams that want crash reporting and push notifications in the same client instead of bolting on separate libraries per concern.
- Developers validating the integration against the
countly-sample-ios example repository before wiring it into a production app.
Getting started
The README lists no package name or installer; it directs readers to the Countly support documentation for adding the SDK to a project and for minimal integration information, and offers the countly-sample-ios repository as a working example. The server side is Countly Lite or Countly Enterprise.
How it compares
The facts provide no list of paid products this SDK replaces, and no competing analytics SDK is named in the README or the topics. It therefore stands alone in this registry as the Countly client for Apple platforms, and its natural companion is the Countly Lite server repository rather than another SDK.
When to use it — and when not to
Adopt it when a Countly server already exists or is planned, because the SDK is a client and delivers nothing on its own; a self-hoster must run and maintain the Countly server in addition to the application. Do not pick it if the goal is a drop-in analytics service with no backend to operate, or if the project needs an SDK outside Objective-C, because Countly publishes separate SDKs for other platforms. The README is also thin on installation detail and delegates setup to external documentation, so expect to leave the repository to finish integration.
project readme (upstream, from github) — read inline
Countly iOS SDK
This repository contains the Countly iOS SDK, which can be integrated into iOS, watchOS, tvOS & macOS applications. The Countly iOS SDK is intended to be used with Countly Lite or Countly Enterprise.
What is Countly?
Countly is a product analytics solution and innovation enabler that helps teams track product performance and customer journey and behavior across mobile, web,
and desktop applications. Ensuring privacy by design, Countly allows you to innovate and enhance your products to provide personalized and customized customer experiences, and meet key business and revenue goals.
Track, measure, and take action - all without leaving Countly.
Integrating Countly SDK in your projects
For a detailed description on how to use this SDK check out our documentation.
For information about how to add the SDK to your project, please check this section of the documentation.
You can find minimal SDK integration information for your project in this section of the documentation.
For an example integration of this SDK, you can have a look here.
This SDK supports the following features:
Security
Security is very important to us. If you discover any issue regarding security, please disclose the information responsibly by sending an email to [email protected] and not by creating a GitHub issue.
Badges
If you like Countly, why not use one of our badges and give a link back to us so others know about this wonderful platform?
<a href="https://count.ly/f/badge" rel="nofollow"><img style="width:145px;height:60px" src="https://count.ly/badges/dark.svg" alt="Countly - Product Analytics" /></a>
<a href="https://count.ly/f/badge" rel="nofollow"><img style="width:145px;height:60px" src="https://count.ly/badges/light.svg" alt="Countly - Product Analytics" /></a>
How can I help you with your efforts?
Glad you asked! For community support, feature requests, and engaging with the Countly Community, please join us at our Discord Server. We're excited to have you there!
Also, we are on Twitter and LinkedIn if you would like to keep up with Countly related updates.