HomeDocumentationAPI Reference
Getting StartedAPI ReferenceBug ReportingCrash ReportingAPMHelp Center
These docs are for v8.2. Click to read the latest docs for v12.0.0.

Setting Custom Data

Discussed here is how to set user attributes and tags, as well as log user events, and their relevant APIs.

User Attributes

You can assign custom attributes to your users and they will show up on your Instabug dashboard with each report. These attributes can later be used to filter reports in your dashboard.

2160

This is where additional user attributes appear in your bug reports.

To add a new user attribute, use the following method.

Instabug.setUserAttribute("True", withKey: "Logged in")
Instabug.setUserAttribute("False", withKey: "Completed IAP")
[Instabug setUserAttribute:@"True" withKey:@"Logged in"];
[Instabug setUserAttribute:@"18" withKey:@"Age"];

You can also retrieve or remove the current value of a certain user attribute.

let loggedIn = Instabug.userAttribute(forKey: "Logged in")
Instabug.removeUserAttribute(forKey: "Logged in")
NSString *loggedIn = [Instabug userAttributeForKey:@"Logged in"];
[Instabug removeUserAttributeForKey:@"Logged in"];

Or retrieve all user attributes.

let allUserAttributes = Instabug.userAttributes()
NSDictionary *allUserAttributes = [Instabug userAttributes];

User Events

You can log custom user events throughout your application. Custom events are automatically included with each report.

Instabug.logUserEvent(withName: "Skipped Walkthrough")
[Instabug logUserEventWithName:@"Skipped Walkthrough"];

Tags

You can add custom tags to your bug and crash reports. These tags can later be used to filter reports or set custom rules from your dashboard.

2160

This is where tags appear in your bug reports.

The example below demonstrates how to add tags to a report.

Instabug.appendTags(["Design", "Flow"])
[Instabug appendTags:@[@"Design", @"Flow"]];

You can also get all the currently set tags as follows.

let tags = Instabug.getTags()
NSString *tags = [Instabug getTags];

Last, you can reset all the tags.

Instabug.resetTags()
[Instabug resetTags];

Managing Tags

If you'd like to remove a particular tag from your dashboard to prevent it from appearing again when entering a new tag manually, you can do so by navigating to the tags page under the settings options and remove the tag. You can also edit and rename the tag.

2880

What’s Next

You now have more information than ever about each bug and crash report, so we suggest you read up more on bug reporting. Also, did you know that you can use custom user attributes and events to target surveys?