Bugsnag Destination

Bugsnag helps you detect and diagnose crashes in your application. Depending on the data you provide, Bugsnag can filter errors based on user name, user email, timeline, release stages, paying user status, and more.

At the moment, we support the following integrations:

Web | Analytics.js SDK 2.1.0 Android | Android SDK 2.0.0 iOS | iOS SDK 1.0.3

This document was last updated on July 11th, 2018. If you notice any gaps, outdated information or simply want to leave some feedback to help us improve our documentation, please let us know!

Getting Started

The first step is to make sure Bugsnag supports the source type and connection mode you’ve chosen to implement. You can learn more about what dictates the connection modes we support here.

📱 Device-mode
☁️ Cloud-mode


  1. From your Segment UI’s Destinations page click on “Add Destination”.
  2. Search for “Bugsnag” within the Destinations Catalog and confirm the project you’d like to connect to
  3. Add your API key to your connection settings. You can find your API key in your Bugsnag dashboard under “Settings”, which is located in the upper left-hand corner
  4. We’ll automatically initialize Bugsnag’s javascript script with your API key upon loading analytics.js


If you’d like to integrate with Bugsnag’s iOS and/or Android SDKs, in addition to completing steps 1-3 in the previous section, you will also need to complete the install steps outlined below:

  1. Android

  2. iOS


Once you’ve correctly set up your Bugsnag integration, you should identify each of your users as soon as you know their identity (this typically happens after log in or sign up), so that Bugsnag can provide you with more visibility into which user is encountering which error.

If you haven’t had a chance to review our spec, please take a look to understand what the Identify method does. An example call would look like:

analytics.identify('ze8rt1u89', {
  name: 'Zaphod Beeblebrox',
  gender: 'Male',
  email: 'Zaphod@hotmail.com',

Bugsnag will show you the userId and traits in the Users tab of each error.

Error Reporting

In addition to sending Bugsnag user-specific information, you can send handled exceptions and diagnostic data to your Bugsnag dashboard using Bugsnag’s native methods. Documentation on these methods is available on their website.

This destination requires Device-mode for Mobile data. Follow the steps above packaged the Bugsnag SDK with Segment’s.


Segment lets you change these destination settings via your Segment dashboard without having to touch any code.


You can find your API Key on your Bugsnag Project Settings page.

Release Stage

Distinguish errors that happen in different stages of your app’s release process e.g ‘production’, ‘development’, etc.


Use SSL When Sending Data to Bugsnag

Adding Bugsnag to the integrations object

To add Bugsnag to the integrations JSON object (for example, to filter data from a specific source), use one of the 1 valid names for this integration:
  • Bugsnag

  • Questions? Need help? Contact us!
    Can we improve this doc?
    Email us: docs-feedback@segment.com!