What's New

Instabug-iOS SDK v11.12.0

  • Adds ability to control, when reporting a non-fatal, whether to capture the stack trace of the calling thread only, or all thread. Set NonFatalError.stackTraceMode to control this.
  • Adds a new callback that’s executed after sending a crash report. Check CrashReporting.didSendCrashReportHandler.
  • Adds ability to control configuration of Repro Steps for Bug Reporting and Crash Reporting separately via Instabug.setReproStepsFor(_:with:).
  • Changes Repro Steps behavior to report the accessibilityIdentifier if a UI element if it doesn’t have text or an accessibilityLabel set.
  • Deprecates Instabug.reproStepsMode.
  • Fixes an issue that resulted in network logs obfuscations done through NetworkLogger.setRequestObfuscationHandler to not be applied. We have remotely disabled the code path that causes this issue, which may result in seeing less network logs until you update to this SDK version.
  • Fixes an issue that caused some network logs to not be included with bug and crash reports.
  • Fixes an issue that caused the title of the dismiss button of the in-app notification not to be localized.
  • Fixes an issue that caused Repro Steps to not be reported in specific scenarios in apps that combine native and React Native views.
  • Fixes an inconsistency in counting crash-free sessions.
  • Fixes an issue that caused emails set via the Instabug.identifyUser API to be ignored if the email field in hidden from the bug reporting UI.

Instabug iOS SDK


Instabug is an in-app feedback and bug reporting tool for mobile apps. With just a simple shake, your users or beta testers can report bugs or send in-app feedback and the SDK will capture an environment snapshot of your user's device including all console logs, server-side network requests and bug reproduction steps compiling all these details in one organised dashboard to help you debug and fix bugs faster.

Instabug also provides you with a reliable crash reporter that automatically captures a detailed report of the running environment, the different threads’ states, the steps to reproduce the crash, and the network request logs. All the data is captured automatically with no need for breadcrumbs, and you can always reply back to your users and they will receive your messages within the app.

For more info, visit



  1. Open project target.
  2. Select Swift packages
  3. Add New package and paste
  4. Make sure to be on the latest.


Please refer to for more installation methods


  1. Import Instabug framework header in your app delegate

    // Swift
    import Instabug
    // Objective-C
    #import <Instabug/Instabug.h>
  2. Add the following to your app delegate's application:didFinishLaunchingWithOptions: method.

    // Swift
    Instabug.start(withToken: <#app token#>, invocationEvents: .shake)
    // Objective-C
    [Instabug startWithToken:<#app token#> invocationEvents:IBGInvocationEventShake];

    Make sure to replace app_token with your application token. Find it here.


Instabug needs access to the microphone and photo library to be able to let users add audio and video attachments. Starting from iOS 10, apps that don’t provide a usage description for those 2 permissions would be rejected when submitted to the App Store.

For your app not to be rejected, you’ll need to add the following 2 keys to your app’s info.plist file with text explaining to the user why those permissions are needed:

  • NSMicrophoneUsageDescription
  • NSPhotoLibraryUsageDescription

If your app doesn’t already access the microphone or photo library, we recommend using a usage description like:

  • "<app name> needs access to the microphone to be able to attach voice notes."
  • "<app name> needs access to your photo library for you to be able to attach images."

The permission alert for accessing the microphone/photo library will NOT appear unless users attempt to attach a voice note/photo while using Instabug.


You can also check out our API Reference for more detailed information about our SDK.


  • Swift Tools 5.3.0
View More Packages from this Author


  • None
Last updated: Tue May 23 2023 13:00:18 GMT-0500 (GMT-05:00)